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草稿 (0.9.0) 

译 者 : ER 

2007-10-25 

2000-2007, Object Refinery Limited. All rights reserved. 


1.1 TZ JFreeChart 


1.1.1 概述 


JFreeChart 是 一 款 免费 的 java 图 形 开 发 类 库 。 主 要 用 来 在 application/ applets/ 
servlets/ jsp/ 上 生成 各 种 图 表 。JFreeChart 是 完全 开源 ， 并 且 严 格 遵循 GNU 的 通用 
公共 许可 证 ， 力 保 JFreeChart 用 户 对 源 代 码 的 自由 修改 与 使 用 。 


Dual Axis Chart 

















图 1.1 一 个 简单 的 图 表 


图 1.1 就 是 一 个 典型 的 使 用 JFreeChart 创 建 的 图 表 。 在 本 文 后 续 章 节 将 陆续 展示 更 多 
的 实例 。 


1.1.2 特征 


JFreeChart 能 产生 饼 图 (pie) 、 柱 状 /条 形 统计 图 (bar) 、 折 线 图 (line) 、 散 点 
图 (scatter plots) 、 时 序 图 (time series) 、 甘 特 图 (Gant) 、 仪 表盘 图 
(meter， 比 如 刻度 盘 、 温 度 计 、 罗 意 等 ) 、 混 合 图 、symbol 图 和 风力 方向 图 等 。 


主要 特征 如 下 : 


定义 接口 的 任何 实现 通俗 易 懂 

易于 导出 PNG 和 JPEG 图 像 文件 格式 (也 可 以 使 用 java 的 图 像 l/O 类 库 生 成 类 库 
支持 的 任何 格式 ) 。 

使 用 Graphics2D 工 具 导 出 其 他 格式 : 

使 用 iText 工 具 导 出 PDF 格式 文件 

使 用 Batik 工 具 导 出 SVG 格式 文件 

图 像 工 具 栏 

图 表 支 持 鼠 标 事件 

支持 注解 。 


e. 产生 HTML 图 像 映射 
可 以 工作 于 application/servlets/jsp/applets 等 环境 。 
e 完全 开源 、 严 格 遵 守 GNU 的 通用 公共 认证 协议 。 


JFreeChart 完 全 由 java 语 言 编写 ， 可 以 运行 在 java2 的 任何 平台 上 (JDK1.3.1 版 本 或 
者 更 高 版 本 ) 


1.1.3 下 载 主 页 


JFreeChart 可 以 在 下 面 的 链接 中 找到 : 


http://www.jfree.org/jfreechart/ 这 里 我 们 可 以 找到 JFreechart 最 新 的 版 本 ， 目 前 是 
1.0.6。 包 括 图 表 实 例 、 下 载 链 接 、javadoc 文 档 、 讨 论 社 区 等 。 


1.2 使 用 文档 


文档 有 两 个 有 效 的 版 本 : 


e 免费 版 本 可 以 充 JFreeChart 主 网 站 上 下 载 免 费 版 本 《JFreeChart Installation 
Guide》， 主 要 讲述 内 容 是 : JFreeChart 的 安装 过 程 和 JFreeChart 实 例 的 运 


{To 
e 收费 版 本 需要 支付 一 定 费 用 才能 获得 《JFreeChart Developer Guide) , XE 
包括 开发 指南 章节 和 JFreeChart 类 参考 文档 。 


1.3 感谢 


JFreeChart 的 代码 和 思路 源 于 很 多 人 。 在 这 里 我 将 感谢 下 面 帮助 JFreeChart 成 长 的 
人 ,也 许 有 些 人 员 名 字 漏 掉 ， 望 给 予 指正 ， 在 此 表示 舱 意 。 名 单 如 下 : 


Richard Atkinson, David Berry, Anthony Boulestreau, Jeremy Bowman, Daniel 
Bridenbecker, Nicolas Brodu, David Browning, S@ren Caspersen, Chuanhao Chiu, 
Pascal Collet, Martin Cordova, Paolo Cova, Michael Duffy, Jonathan Gabbai, 
Serge V. Grachov, Hans-Jurgen Greiner, Joao Guilherme Del Valle, Aiman Han, 
Jon lles, Wolfgang Irler, Xun Kang, Bill Kelemen, Norbert Kiesel, Gideon Krause, 
Arnaud Lelievre, David Li, Tin Luu, Craig MacFarlane, Achilleus Mantzios, 
Thomas Meier, Aaron Metzger, Jim Moore, Jonathan Nash, Barak Naveh, David 
M. O’Donnell, Krzysztof Paz, Tomer Peretz, Andrzej Porebski, Luke Quinane, 
Viktor Rajewski, Eduardo Ramalho, Michael Rauch, Cameron Riley, Dan Rivett, 
Michel Santos, Thierry Saura, Andreas Schneider, Jean-Luc Schwab, Bryan Scott, 
Roger Studner, Irv Thomae, Eric Thomas, Rich Unger, Daniel van Enckevort, 
Laurence Vanhelsuw’e, Sylvain Vieujot, JelaiWang, MarkWatson, Alex Weber, 
Matthew Wright, Christian W. Zuckschwerdt, Hari and Sam (oldman). 


1.4 建议 


如 果 您 对 本 文档 有 任何 的 建议 或 想法 ， 请 发 送 : david.gilbert@object- 
refinery.com, 


2 图 表 实 例 


2.1 介绍 


本 章节 显示 了 许多 使 用 JFreeChart 创 建 的 图 表 实 例 。 内 容 特 意 对 JFreeChart 产 生 的 
图 表 类 型 做 了 概述 。 运 行 实例 命令 如 下 : 


java -jar jfreechart-1.0.6-demo. jar 


如 果 您 购买 了 《JFreeChart Developer Guide》， 可 获得 该 实例 的 源 代码 。 
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2.2 饼 图 (Pie Charts) 


JFreeChart 能 够 创 使 用 符合 PieDataset 接 口 标准 的 数据 创建 饼 图 。 下 图 2.1 显 示 了 一 


个 简单 的 饼 图 。 


Pie Chart Demo 1 











图 2.1 一 个 简单 的 饼 图 (参见 : PieChartDemo1.java) 
其 中 ， 单 个 的 区 域 也 可 以 被 "取出 ” 如 下 图 2.2 所 示 : 
Pie Chart Demo 2 


[Six (15% percent) | 


{One (34% percent) 
Five O% percent) | 


Four(14% percent) Á ~ 
| Two (8% percent) 
| 
} 





图 2.2 一 个 带 有 取出 "区域 "的 饼 图 (参见 : PieChartDemo2 java) 


2.2 饼 图 (Pie Charts) 











15 
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我 们 也 可 以 显示 3D 效 果 的 饼 图 ， 如 下 图 2.3 所 示 : 
Pie Chart 3D Demo 1 








图 2.3 3D 效 果 图 的 图 表 (参见 : PieChart3DDemol java) 
3D 效 果 的 饼 图 ， 部 分 区 域 不 能 取出 。 


2.2 饼 图 (Pie Charts) 
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3 BARA (Bar Charts) 


JFreeChart 可 以 创建 一 系列 的 直方 条 形 图 。 创 建 直方 条 形 图 的 数据 必须 符合 
CategoryDataset 接 口 标准 。 图 2.4 显 示 了 一 个 垂直 定向 的 直方 条 形 图 。 





Bar Chart Demo 1 





了 oo se" RON 
o? o? e? ç* ç? 
Category 
图 2.4 一 个 垂直 的 直方 条 形 图 (参见 : BarChartDemo1.java) 
直方 条 形 图 可 以 用 3D 效 果 显 示 ， 如 下 图 2.5 所 示 。 





3D Bar Chart Demo 


Category 





E Series 1 m Series 2 — Series3 Series4 = Series 5 ~ Series ô ` Series 7 M Series 8 m Series 9 


$2.5 3D 效 果 的 直方 条 形 图 (参见 : BarChart3DDemo1.java) 
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直方 条 形 图 的 另 一 种 变型 ， 瀑 布 图 表 。 如 下 图 2.6 所 示 : 
Product Cost Breakdown 


= 
[= 
23 
= 
c 
a. 
q 
w 
o 
o 


Administration Marketing Distribution Total Expense 
Expense Category 


如 2.6 一 个 瀑布 图 表 (参见 : WaterfallChartDemo1 java) 
直方 条 形 图 可 以 从 时 序数 据 中 产生 。 如 下 图 2.7 所 示 : 
State Executions - USA 


Source: http Awww. amnestyusa org/abolish/listbyyeardo 


Number of People 
8 


8 8 ë 8 S8 3d 8 S 


o c. 
1976 1978 1980 1982 1984 1988 1988 1990 1992 1994 1996 1998 2000 2002 2004 
Year 


图 2.7 一 个 XY 图 表 (8 XYBarChartDemo1 java) 


2.3 直方 条 形 图 (Bar Charts) 
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2.4 折线 图 (Line Charts) 


折线 图 可 以 使 用 直方 条 形 图 的 数据 对 象 CategoryDataset 产 生 。 如 下 图 2.8 : 
=) See os NEU EU TTIT 











图 2.8 一 个 折线 图 (6#LineChartDemo1 java) 


2.4 折线 图 (Line Charts) 19 


2.5 XY( 散 点 图 ) 


XYDataset 是 第 三 种 数据 类 型 ， 用 来 产生 一 系列 图 表 的 类 型 。 标 准 的 XY 区 域 有 X 和 
Y 数 轴 。 默 认 的 ， 使 用 相应 的 数据 按照 一 定 比 例 画 出 X 轴 和 Y 轴 。 如 图 2.9 所 示 。 





Line Chart Demo 4 








图 2.9 折线 图 (参考 : LineChartDemo4 java) 


散 点 图 是 每 一 个 数据 点 用 一 个 图 形 画 出 来 ， 而 不 是 使 用 线 将 点 连 起 来 。 一 个 实例 如 
下 图 2.10 所 示 : 


Scatter Plot Demo 1 








图 2.10 散 点 图 (参考 : ScatterPlotDemol java) 
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2.6 时 序 图 


JFreeChart 支 持 时 间 序 列 图 表 ， 时 序 图 包括 平均 值 图 、high-low-open-close 图 和 
candlestick 图 ， 如 下 图 2.11 所 示 : 


Legal & General Unit Trust Prices 


= 
c 
2 
- 
m 
a 
o 
o 
= 
a 





图 2.11 序列 图 (参考 : TimeSeriesDemo1 java) 
我 们 可 以 在 时 序 图 上 添加 一 条 平均 值 线 一 一 如 下 图 2.12 所 示 : 


Time Series Demo 8 





三 月 .2001 五 月 .2001 七 月 ,2001 九 月 .2001 
Date 


一 EURIGBP 一 30 day moving average 


图 2.12 带 有 平均 线 线 的 时 序 图 (参考 : TimeSeriesDemo8 java) 





2.6 时 序 图 22 


我 们 可 以 使 用 OHLCDataset (XYDataset 的 扩展 ) 显示 high-low-open-close 数 据 图 
表 。 如 下 图 2.13 所 示 : 





"TAS uum 








m Series 1 — Series 1-MAVG 


图 2.13 high-low-open-close 图 表 (参考 : HighLowChartDemo2.java)) 


L [= 5 
L.O BY HH L 
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2.7 柱状 图 


可 以 使 用 一 个 IntervalXYDataset (XYDataset 的 另 一 个 扩展 ) 数据 产生 柱状 图 。 如 
下 图 2.14 所 示 : 


Histogram Demo 1 


1 


20 25 30 36 40 45 60 55 60 65 70 75 80 85 90 95 100 





图 2.14 柱状 图 (参考 : HistogramDemo1 java) 


2.7 柱状 图 24 
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2.8 面积 图 


我 们 可 以 使 用 CategoryDataset 或 者 XYDataset 产 成 面积 图 表 。 如 下 图 2.15 所 示 : 


XY Area Chart Demo 


Domain (X) 
图 2.15 面积 图 (参考 : XYAreaChartDemo1 java) 
同时 ，JFreeChart 也 支持 堆栈 式 面 积 图 表 ， 如 下 图 2.16 所 示 : 
Stacked XY Area Chart Demo 1 








12 13 
XValue 


E Seres! a Saras 2] 
图 2.16 堆栈 式 面 积 图 (参考 : StackedXYAreaChartDemo1.java) 





2.8 面积 图 25 
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2.9 ERE 


异 图 是 显示 两 个 序列 之 间 的 不 同 。 如 下 图 2.17 所 示 。 


Difference Chart Demo 1 


上 “月 -2007 上 一 用 -2007 H-2008 —H-2008 =H-2008 2411-2008 
Time 


图 2.17 差异 图 (参考 : DifferenceChartDemo1.java) 


Daylight Hours - London, UK 


Data source: http.-//www.sunrisesunset com/ 


1471-2004 六 中 -2004 从 月 -2004 |-2004 
Time 


图 2.18 差异 图 (参考 : DifferenceChartDemo2.java) 


2.9 差异 图 


五 月 -200 





| 一 月 -2004 
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2.10 HEH 


梯形 图 使 用 一 系列 的 “梯形 "来 显示 数据 数值 。 一 一 如 下 图 2.19 所 示 : 
XYStepRenderer Demo 1 


一 -一 -十 -一 一 一 


30 3.5 40 
X 


图 2.19 梯形 图 (参考 : XYStepRendererDemo1 java) 
梯形 图 数据 使 用 XYDataset 数 据 对 象 。 





2.11 甘 特 图 


我 们 可 以 使 用 IntervalCategoryDataset 数 据 集 类 产生 甘 特 图 。 如 图 2.20 所 示 


Gantt Chart Demo 


Date 
五 月 -2001 /L/]-2001 





Write Proposal 


Obtain Approval 


Requirements Analysis 
Design Phase 

Design Signoff 

Alpha Implementation 
Design Review 
Revised Design Signoff 
Beta Implementation 
Testing 

Final Implementation 


Signoff 








52.20 甘 特 图 (参考 : GanttChartDemo1 java) 
此 外 ， 甘 特 图 可 以 具有 子 任务 和 进度 显示 器 。 如 下 图 2.21 所 示 


Gantt Chart Demo 
Date 





Write Proposal 

Obtain Approval 
Requirements Analysis 
Design Phase 

Design Signoff 

Alpha Implementation 
Design Review 
Revised Design Signoff 
Beta Implementation 
Testing 

Final Implementation 


Signoff 








42.21 带 有 进度 显示 的 甘 特 图 


门口 


91 Hee )5 
2.11 EF I) Zo 
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2.12 多 轴 图 
JFreeChart 支 持 多 轴 图 表 。 如 下 图 2.22 显 示 了 一 个 价格 一 数量 的 图 表 。 








Eurodollar Futures Contract (MAR03) 





D 
^ H-2002 + -H-2002 


— Price E Volume 


图 2.22 价格 一 数量 图 表 (参考 : PriceVolumeDemo1 java) 
CategoryPlot 和 XYPot 支 持 多 轴 特 征 。 图 2.23 显 示 了 一 个 具有 四 个 数 轴 的 图 表 。 


Multiple Axis Demo 1 
Four datasets and four range axes. 


£ Siy abuey 


E] 
T 
° 
4 S 
2 a 
z = 
= S 
a E 

‘Ss 

a 


15:00 15:30 16:00 16:30 17:00 17:30 18:00 
Time of Day 


12.23 多 轴 图 表 (参考 : MultipleAxisDemot java) 





2.12 多 轴 图 29 





2.13 & & 8 =a E 


JFreeChart 支 持 复合 /覆盖 图 表 。 图 2.24 显 示 了 一 个 条 形 图 上 覆盖 了 一 个 折线 图 。 


Freshmeat Software Projects 
By Programming Language 
As at 5 March 2003 


Projects 








| 


Unix Shell 
SQL 
ce 


Language 
图 2.24 覆盖 图 (参考 : ParetoChartDemo1 java) 
也 有 可 能 使 用 同一 个 主轴 ， 组 合 几 种 图 表 。 如 下 图 2.25。 


Combined Domain Category Plot Demo 





a 


Type 1 Type 2 Type 3 Type 4 Type 5 Type 6 Type 7 Type 8 





Category 


12.25 带 有 公共 区 域 的 图 表 (参考 : CombinedCategoryPlotDemo1 java) 
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类 似 的 ，JFreeChart 可 以 复合 几 种 图 表 ， 共 用 相同 刻度 范围 的 轴 。 如 图 2.26 所 示 : 





Combined (Range) XY Plot 





E Series 1 — Series 2 


42.26 共用 相同 范围 轴 的 复合 图 表 (参考 : CombinedXYPlotDemo2 java) 





2.13 复合 / 履 盖 图 31 


2.14 开发 远景 

JFreeChart 为 免费 软件 ， 任 何人 可 以 扩展 它 ， 可 以 添加 新 的 特征 。 已 经 有 80 多 人 向 
JFreeChart 项 目 贡献 代码 。 不 久 开发 者 将 开发 更 多 的 图 表 来 满足 更 多 的 需求 。 我 们 
可 以 从 JFreeChart 网 站 上 获得 更 多 的 信息 和 版 本 的 更 新 : 
http://www.jfree.org/jfreechart/ 


欢迎 您 的 加 入 。 


3 下 载 和 安装 JFreeChart 1.0.6 


3.1 简介 


本 章 主 要 介绍 JFreeChart 的 下 载 、 解 包 和 编译 内 容 。 同 时 讲述 如 何 运行 JireeChart 
应 用 实例 ， 如 何 从 源 代 码 生 成 JavaDoc 的 HTML 文 件 内 容 等 。 


3.2 FX 


我 们 可 以 从 JFreeChart 主 网 站 上 获得 最 新 的 JFreeChart 版 本 : 
http://www.jfree.org/jfreechart/download 
网 页 上 提供 了 两 个 可 下 载 的 版 本 : 
文件 描述 
jfreechart-1.0.6.tar.gz Linux/Unix 版 本 
jfreechart-1.0.6.zip Windows 版 本 
这 两 个 文件 包含 相同 的 源 代 码 。 主 要 不 同 在 于 下 载 的 zip 文 件 中 所 有 的 文本 文件 已 被 
重新 编码 ， 有 回 车 返回 ， 并 且 每 行 结尾 有 换行 符号 。 


JFreeChart 是 有 JCommon (目前 版 本 是 1.0.9) 基础 类 库 .JCommon 是 运行 时 的 jar 
文件 ， 在 JFreeChart 下 载 时 ， 包 含 该 jar 文 件 。 如 果 你 需要 JCommon 的 源 代码 ， 可 
以 从 下 面 链接 下 载 : 


http://www.jfree.org/jcommon/ 


3.3 解 包 


下 载 完 JFreeChart 压 缩 文件 之 后 ， 我 们 需要 将 该 压缩 文件 解 开 。 我 们 可 以 将 文件 解 
压 到 指定 的 目录 下 面 。 


3.3.1 Linux/Unix 环 境 下 解压 
在 Linux/Unix 环 境 下 解压 文件 ， 使 用 下 面 命 令 : 


tar xvzf jfreechart-1.0.6.tar.gz tar xvzf jfreechart-1.0.6.tar.gz 
EEO 


该 命令 将 JFreeChart 所 有 的 文件 包括 源 代 码 ， 运 行 jar 文 件 和 doc 文 档 解压 到 
jfreechart-1.0.6 目 录 下 面 。 


3.3.2 Windows 环 境 下 解压 
在 Windows 环 境 下 解压 文件 ， 使 用 下 面 命 令 : 


jar -xvf jfreechart-1.0.6.zip 


该 命令 将 JFreeChart 所 有 的 文件 包括 源 代 码 ， 运 行 jar 文 件 和 doc 文 档 解压 到 
jfreechart-1.0.6 目 录 下 面 。 


3.3.3 文件 目录 说 明 
解压 后 的 jfreechart-1.0.6 目 录 下 面 ， 有 许多 文件 和 文件 夹 ， 列 表 如 下 : 


文件 /目录 


Ant 


checkstyle 


experimental 
gjdoc 

lib 

source 

swt 


Tests 


jfreechart-1.0.6- 
demo.jar 


CHANGELOG .txt 
ChangeLog 
licence-LGPL.txt 
NEWS 
README.txt 


说 明 
该 目录 下 面包 含 了 一 个 ant 的 build.xml 脚 本 。 我 们 使 用 该 脚 
本 可 以 用 现 有 的 版 本 源 代 码 重 新 构建 JFreeChart。 


该 目录 下 面包 含 了 几 种 检查 风格 属性 文件 。 文 件 定义 了 
JFreeChart 中 的 编码 规范 。 


该 文件 夹 下 面包 含 了 一 些 不 属于 JFreeChart 标 准 API 的 类 文 
件 。 注 意 这 些 代 码 的 API 可 能 会 改变 。 


该 文件 夹 下 面包 含 了 一 种 产生 JFreeChart 文 档 的 脚本 。 


该 目录 下 面包 含 了 JFreeChart 的 jar 文 件 ， 以 及 JFreeChart 
依赖 的 jar 文 件 。 


JFreeChart 源 代码 目录 。 


该 目录 下 面包 含 了 具有 实践 经 验 的 swt 源 代码 。 注 意 该 代码 
API 有 可 能 发 生 改 变 。 


JFreeChart 单 元 测试 的 源 代 码 文 件 。 
一 个 具有 实例 演示 的 可 运行 的 jar 文 件 。 
老 的 JFreeChart 变 更 的 日 志 记 录 。 
JFreeChart 变 更 的 详细 日 志 记 录 。 
JFreeChart 公 共 认 证 (GNU LGPL) 
JFreeChart 项 目 新 闻 


重要 信息 一 一 定 要 读 ! 


我 们 应 当 花 一 部 分 时 间 来 熟悉 这 些 文件 ， 并 详细 的 阅读 README.txt 文 件 。 


3.4 运行 演示 实例 


在 解压 的 文件 中 ， 有 一 个 实例 演示 应 用 包含 了 JFreeChart 产 生 的 大 量 图 表演 示 实 
例 。 输 入 下 面 命 令 可 以 运行 该 应 用 : 


java -jar jfreechart-1.0.6-demo. jar 


实例 的 源 代码 跟 JFreeChart 开 发 指南 一 并 发 行 ， 是 收费 的 。 


3.5 编译 源 代码 


我 们 可 是 使 用 ant 的 build.xml 文 件 重 新 编译 JFreeChart 类 文件 。 进 入 ant 上 目录， 然后 
键入 : 


ant complie 


这 将 重新 编译 全 部 的 源 文件 和 创建 创建 JFreeChart 运 行 时 依赖 的 jar 文 件 。Ant 工 具 
需要 1.5.1 版 本 或 更 高 版 本 ， 我 们 可 以 从 下 面 链 接 获 得 更 多 ant 信 息 : 


http://ant.apache.org/ 


3.6 产生 javadoc 文 档 


JFreeChart 源 代码 文件 中 包含 了 大 量 丰 富 的 Javadoc 注 释 。 我 们 使 用 javadoc 工 具 可 
以 直接 从 源 代码 中 产生 HTML 文 件 。 


产生 javadoc 文 件 使 用 ant 的 javadoc 目 标 ， 进 入 ant 目 录 键 入 : 


ant javadoc 


这 将 产生 javadoc 目 录 。 目 录 下 面包 含 了 全 部 的 Javadoc 的 HTML 文 件 。 


4 (= FA JFreeChart1.0.6 


4.1 概述 


" a s L 户 编写 了 一 个 简单 的 实例 ， 以 说 明 JFreeChart 的 使 


4.2 创建 第 一 个 图 表 


4.2.1 概述 


使 用 JFreeChart 创 建 图 表 共 有 三 个 步骤 。 如 下 : 


e 创建 一 个 dataset。 该 dataset 包 含 图 表 要 显示 的 数据 。 
e 创建 一 个 JFreeChart 对 象 。 该 对 象 负 责 画 这 个 图 表 。 
e 创建 一 个 输出 目标 (如 : 一 个 panel， 显 示 在 屏幕 上 ) 。 该 输出 目标 画 这 个 图 


o 


下 面 ， 我 们 使 用 一 个 简单 的 应 用 (Firstjava) 来 描述 这 个 过 程 。 该 应 用 产生 了 一 个 
饼 图 ， 如 下 图 4.1 所 示 : 


BER 
Sample Pie Chart 


图 4.1 创建 的 第 一 个 饼 图 (SFFirst.java) 
上 面 描述 的 三 个 步骤 ， 将 在 下 面 的 章节 里 面 ， 均 有 代码 详细 说 明 。 





4.2.2 数据 


步骤 一 要 求 我 们 为 我 们 的 图 表 创 建 一 个 dataset。 使 用 DefaultPieDataset 类 可 以 很 容 
易 创 建 。 如 下 代码 : 


// create a dataset... 

DefaultPieDataset dataset = new DefaultPieDataset(); 
dataset.setValue("Category 1", 43.2); 
dataset.setValue("Category 2", 27.9); 
dataset.setValue("Category 3", 79.5); 


`š š 
>= Ae. 


JFreeChart 可 以 使 用 符合 PieDataset 接 口 的 任何 实现 数据 来 创建 饼 图 。 
DefaultDataset 类 实现 了 PieDataset 接 口 ， 提 供 了 一 种 便利 的 使 用 方式 。 


我 们 可 以 自由 的 开发 符合 实际 需 的 任意 PieDataset 接 口 实现 。 


4.2.3 创建 一 个 饼 图 


步骤 二 关心 的 是 我 们 如 何 使 用 这 个 dataset 展 示 在 区 域 中 。 这 就 需要 我 们 创建 一 个 
JFreeChart 对 象 ， 该 对 象 使 用 我 们 的 饼 图 dataset 数 据 画 一 个 图 表 。 我 们 使 用 
ChartFactory 类 来 创建 ， 代 码 如 下 : 


// create a chart... 
JFreeChart chart = ChartFactory.createPieChart ( 
"Sample Pie Chart", 
dataset, 
true, // legend? 
true, // tooltips? 
false // URLs? 
); 


注意 : 

代码 中 将 一 个 dataset 的 引用 传人 到 工厂 方法 中 。JFreeChart 持 有 这 个 dataset 引 用 
的 目的 是 便于 在 画图 表 时 能 够 获得 数据 。 使 用 JFreeChart 创 建 图 表 有 许多 定制 外 观 
的 方式 ， 在 这 个 例子 中 我 们 使 用 缺 省 的 属性 值 。 后 面 章节 将 详细 介绍 。 

4.2.4 显示 图 表 


ne 图 表 。JFreeChart 提 供 了 非常 灵活 的 图 表 输 出 
方式 o 


现在 我 们 可 以 在 一 个 屏幕 的 框架 中 显示 这 个 图 表 。ChartFrame 具 有 显示 图 表 的 机 制 
(ChartPanel) 。 代 码 如 下 : 


// create and display a frame... 

ChartFrame frame = new ChartFrame("First", chart); 
frame.pack(); 

frame.setVisible(true); 


代码 全 部 完成 ， 运 行 main() 方 法 ,可 以 出 现 图 4.1 界 面 。 


4.2.5 全 部 程序 代码 
下 面 是 整个 例子 的 全 部 代码 ， 更 加 清楚 的 看 到 我 们 需要 导入 的 类 包 和 实现 方法 。 


public class First { 
public static void main(String[] args) { 
// create a dataset... 
DefaultPieDataset dataset = new DefaultPieDataset(); 
dataset.setValue("Category 1", 43.2); 
dataset.setValue("Category 2", 27.9); 
dataset.setValue("Category 3", 79.5); 
// create a chart... 
JFreeChart chart = ChartFactory.createPieChart ( 
"Sample Pie Chart", 
dataset, 
true, // legend? 
true, // tooltips? 
false // URLS? 
); 
// create and display a frame... 
ChartFrame frame - new ChartFrame("First", chart); 
frame.pack(); 
frame.setVisible(true); 


5 + (Pie Charts) 


5.1 简介 


本 章 主 要 讲解 JFreeChart 中 饼 图 的 一 些 特征 。 内 容 如 下 : 


e 控制 颜色 和 人 饼 图 片区 的 外 请 
e null4& 41125 45 B^] 4c 18 
e 饼 图 片区 的 标签 〈 定 制 文 本 ， 改 变 分 配 的 比例 空间 ) 
。“ 取 出 ” 某 个 片区 
e 多 个 饼 图 显示 
e 显示 3D 效 果 的 饼 图 
更 多 的 信息 ， 可 以 参见 PiePlot 参 考 文档 ， 见 章节 33.72。 


5.2 创建 一 个 简单 的 饼 图 (Pie Charts) 


在 前 面 的 第 四 章 的 手把手 的 向 导 里 创建 了 一 个 简单 的 饼 图 。 在 这 里 不 做 详细 介绍 。 


5.3 片区 颜色 


饼 图 片区 缺 省 填充 的 颜色 是 自动 分 配 的 ， 正 如 你 上 面 实例 看 到 的 。 如 果 你 不 喜欢 这 
个 缺 省 的 颜色 ， 你 可 以 实用 setSectionPaint () 方法 来 设置 片区 颜色 。 例 如 : 


PiePlot plot = (PiePlot) chart.getPlot(); 
plot.setSectionPaint("Section A", new Color(200, 255, 255)); 
plot.setSectionPaint("Section B", new Color(200, 200, 255)); 


JFreeChart 的 实例 PieChartDemo2.java 演 示 了 如 何 定制 颜色 。 在 JFreeChart 的 代码 
中 ， 片 区 颜色 使 用 三 层 色 属性 机 制 来 定义 的 。 同 时 ， 我 们 也 可 以 对 饼 图 中 的 每 一 个 
系列 定义 填充 的 颜色 ， 这 里 我 们 不 做 细 述 ， 更 多 的 信息 请 参阅 PiePlot 类 (33.278 
DE 


5.4 F KAR 


B— MIRA RAAB RRA ABMS. PiePlot# fet T SD Fit 


项 : 
e TER X mh ER 


通过 改变 缺 省 的 值 来 改变 全 部 的 片区 外 廓 
e 单独 改变 部 分 饼 图 的 片区 外 廓 


5.4.1 卢 区 外 廓 的 可 见 性 控制 
为 了 完全 关闭 片区 外 廓 ， 使 用 下 面 代码 : 


PiePlot plot = (PiePlot) chart.getPlot(); 
plot .setSectionOutlinesVisible(false); 


在 任何 时 候 ， 你 只 需要 使 用 下 面 代 码 可 以 让 外 廓 显示 出 来 : 


plot.setSectionOutlinesVisible(true); 


调用 该 方法 可 以 触发 PlotChangeEvent 事 件 。 


5.4.2 片区 外 廓 的 控制 


在 片区 外 廊 显 示 的 时 候 ， 我 们 可 以 改变 饼 图 片区 的 整个 外 廓 颜色 或 风格 或 者 单个 饼 
图 片区 的 颜色 或 风格 。 整 个 外 廊 颜 色 或 风格 的 修改 需要 在 基本 层 里 面 设 置 ， 单 个 饼 
图 片区 的 颜色 设置 需要 在 系列 屋 中 设置 。 在 基本 层 里 ， 如 果 没 有 更 高 层 的 颜色 设 
站 
DRA : 


public void setBaseSectionOutlinePaint(Paint paint); 
public void setBaseSectionOutlineStroke(Stroke stroke); 


有 时 候 在 图 表 里 面 ， 我 们 会 更 喜欢 设置 饼 图 里 面 某 个 具体 的 片区 的 外 廓 的 颜色 ， 或 
许 突出 显示 某 些 片区 的 细节 方面 。 做 到 这 些 ， 我 们 可 以 是 使 用 系列 层 层 设 置 ， 通 过 
下 面 的 方法 来 定义 。 


public void setSectionOutlinePaint(Comparable key, Paint paint); 
public void setSectionOutlineStroke(Comparable key, Stroke stroke), 
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方法 的 第 一 个 参数 是 dataset 的 片区 关键 值 。 如 果 我 们 将 该 值 设 为 null， 则 系统 将 使 
用 基本 层 的 设置 。 


5. 5 77 B, (AA ñ VA 值 


PieDataset 可 能 会 包含 一 些 饼 图 不 可 能 显示 的 数值 ， 比 如 null、 需 值 或 者 负 值 。xy 

于 这 些 数 据 PiePlot 类 有 专门 的 处 理 机 制 来 处理 。 如 果 是 需 值 ， 并 且 该 值 有 意 mox. 
PiePlot 类 默认 将 一 个 标签 放置 在 饼 图 片区 显示 的 位 置 ， 并 且 在 图 表 的 图 例 中 添加 一 
zs 。 如 果 需 值 可 以 忽略 ， 我 们 可 以 使 用 下 面 代 码 设置 一 个 标志 ， 不 显示 该 数 
FE : 


PiePlot plot = (PiePlot) chart.getPlot(); 
plot.setlIgnoreZeroValues(true); 


类 似 的 null 值 也 是 如 此 人 处理，nul 值 代表 dataset 丢 失 或 者 不 知 来 源 的 值 。 缺 省 的 处 理 
与 需 值 相同 ， 如 果 忽 略 null 值 ， 则 代码 如 下 : 


PiePlot plot = (PiePlot) chart.getPlot(); 
plot.setlIgnoreNullValues(true); 


在 饼 图 中 处 理 负 值 是 非常 不 明知 的 ， 所 以 在 JFreeChart 中 负 值 总 是 被 忽略 的 。 


5.6 片区 和 图 例 标签 
片区 标签 使 用 的 文本 ， 即 可 以 在 图 表 上 显示 ， 也 可 以 在 图 表 的 图 例 上 显示 ， 并 且 完 
全 可 以 定制 。 标 签 是 自动 默认 产生 的 ， 但 我 们 可 以 使 用 下 面 方法 来 改变 : 


public void setLabelGenerator(PieSectionLabelGenerator generator); 
public void setLegendLabelGenerator(PieSectionLabelGenerator gener: 
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StandPieSectionLabelGenerator 类 专门 用 来 生成 图 例 的 一 个 实现 类 ， 提 供 有 灵活 义理 
定制 标签 的 功能 (如 果 你 不 喜欢 用 这 个 类 ， 可 以 定义 自己 的 类 ， 只 要 实现 接口 
PieSectionLabelGenerator 即 可 ) 。Dataset 显 示 出 的 标签 值 由 Javade 信 息 格式 类 来 
进行 格式 化 一 表 5.1 所 示 格 式 化 的 变量 值 。 


名 称 描述 
{0} 片区 关键 值 (FFR) 
{1} 片区 值 
{2} 百分比 的 片区 值 


表 5.1 StandardPieSectionLabelGenerator substitutions 


下 面 举例 说 ， 假 如 我 们 有 一 个 PieData 包 含 下 面 的 值 


片区 标识 片区 值 
S1 3.0 
S2 5.0 
S3 Null 
S4 2.0 


K 5.2 一 个 dataset 实 例 
下 面 是 格式 化 字符 串 产 生 的 标签 值 内 容 : 


格式 化 字符 串 片区 产生 的 标签 值 
{0} 0 S1 
(0) has value {1} 1 S2 has value 5.0 
{0}({2} percent) 0 $1(30 percent) 


(0) = {1} 2 S3 = null 


类 PieChartDemo2.java 使 用 了 定制 标签 的 方法 。 


5.7“ 取 出 ” 某 个 片区 

PiePlot 类 支持 将 某 个 片区 “取出 “显示 。 即 某 个 片区 偏离 图 表 中 心 ， 以 突出 显示 。 如 
类 所 显示 。 

片区 偏离 的 数值 是 图 表 半 径 的 一 个 百 分 值 来 表示 。 例 如 0.3 (30 persent) 代码 偏离 
的 值 是 半径 的 长 度 x0.3. 代 码 如 下 : 


PiePlot pieplot = (PiePlot) jfreechart.getPlot(); 
pieplot.setExplodePercent("Two", 0.5); 


5.8 3D 饼 


JFreeChart 具 有 一 个 实现 3D 效 果 的 饼 图 类 PiePlot3D， 如 图 5.5 所 示 ， 
(PieChart3DDemo1.java)。PiePlot3D 是 PiePlot 的 子 类 ， 因 此 在 我 们 创建 自己 的 饼 
图 时 ， 使 用 PiePlot3D 蔡 换 掉 原来 的 PiePlot 即 可 。 创 建 3D 效 果 的 饼 图 时 ， 使 用 
ChartFactory 的 createPieChart3D () 方法 ， 而 不 是 createPieChart () 方法 。 


= Pie Chart 3D Demo 1 


Pie Chart 3D Demo 1 
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如 5.5 3D 效 果 图 。 
对 于 该 类 有 一 些 限 制 ， 如 下 : 


e 不 支持 ”取出 ”片区 功能 。 
e 不 支持 轴 项 转动 一 一 如 果 支 持 ，3D 效 果 图 可 能 会 变型 。 


3D 的 实例 主要 是 类 PieChart3DDemo1-3.java。 讲 解 类 中 没有 列 出 其 他 两 个 。 因 为 
功能 雷同 于 非 3D 效 果 。 


5.9 多 饼 图 


我 们 可 是 使 用 类 MultiplePiePlot 在 一 个 图 表 上 显示 多 个 饼 图 。 饼 图 的 数据 使 用 
CatoryDataset。 如 图 5.6 所 示 。 每 个 独立 的 饼 图 由 一 个 专门 的 图 表 多 次 创建 而 成 。 

创建 的 每 一 个 饼 图 的 PieDataset 是 由 系统 提供 的 CategoryDataset 按 照 行 或 者 列 拆 分 
出 来 的 。 代 码 见 5.10.11. 


* Multiple Pie Chart Demo 1 


Multiple Pie Chart 


— sem 
SwesQ2 


Region 1 Region 2 Region 3 


[Seno] — [aom] 
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Region 4 Region 5 


456 多 饼 图 图 表 











5.10 实例 讲解 


5.10.1 体会 
也 分 为 三 层 界面 显示 层 、 数 据 层 、 控 制 层 。 


数据 层 比 较 复杂 。 每 个 图 形 有 不 同 的 数据 类 型 。Dataset 类 控制 。 
控制 层 Plot， 饼 图 使 用 PiePlot 设 置 显 示 的 图 形 的 面貌 的 控制 ，JFreeChart 最 丰 


富 的 功能 。 
e 设置 片区 颜色 
e 设置 标签 (文本 格式 、 背 景 颜 色 等 ) 
e 设置 是 否 取出 某 块 。 
e 设置 饼 图 是 否 为 圆 形 
e 设置 饼 图 旋转 。 
e 显示 层 JFreeChart 使 用 数据 、 控 制 直接 将 数据 显示 出 来 。 


5.10.2 类 PieChartDemo1.java 
效果 图 如 下 : 


= Pie Chart Demo 


Pie Chart Demo 1 





代码 编写 典型 的 使 用 了 面 对 对 象 的 方法 : 
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createC hart 





create atuset 


全 部 代码 如 下 : 


package demo; 
java.awt.Dimension; 
java.awt.Font; 
javax.swing.JPanel; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
public 


[Por 


* 


i 


org.jfree. 
org.jfree. 
org.jfree. 
org.jfree. 
org.jfree. 
org.jfree. 
org.jfree. 
org.jfree. 
org.jfree. 


ateD em oP ane 10 


chart 
chart 


chart. 
chart. 
chart. 


.ChartFactory; 
.ChartPanel; 


JFreeChart; 
plot.PiePlot; 
title.TextTitle; 


data.general.DefaultPieDataset; 
data.general.PieDataset; 
ui.ApplicationFrame; 
ui.RefineryUtilities; 

class PieChartDemo1 extends ApplicationFrame í 


private static final long serialVersionUID = 25985575577240854; 
public PieChartDemodi(String string) í 

super(string); 
JPanel jpanel - createDemoPanel(); 
jpanel.setPreferredSize(new Dimension(500, 270)); 
setContentPane(jpanel); 


J 

private static PieDataset createDataset() { 
DefaultPieDataset defaultpiedataset - new DefaultPieDatasel 
defaultpiedataset.setValue("One", new Double(43.2)); 
defaultpiedataset.setValue("Two", new Double(10.0)); 
defaultpiedataset.setValue("Three", new Double(27.5)); 
defaultpiedataset.setValue("Four", new Double(17.5)); 
defaultpiedataset.setValue("Five", new Double(11.0)); 
defaultpiedataset.setValue("Six", new Double(19.4)); 
return defaultpiedataset; 

} 

private static JFreeChart createChart(PieDataset piedataset) { 
JFreeChart jfreechart = ChartFactory.createPieChart("Pie Cl 
piedataset, true, true, false); 
TextTitle texttitle - jfreechart.getTitle(); 
texttitle.setToolTipText("A title tooltip!"); 
PiePlot pieplot - (PiePlot) jfreechart.getPlot(); 
pieplot.setLabelFont(new Font("Arial Black", 0, 20)); 
pieplot.setNoDataMessage("No data available"); 
pieplot.setCircular(false); 
pieplot.setLabelGap(0.02); 
return jfreechart; 

} 

public static JPanel createDemoPanel() { 
JFreeChart jfreechart = createChart(createDataset()); 
return new ChartPanel(jfreechart); 

} 

public static void main(String[] strings) { 
PieChartDemo1 piechartdemoi = new PieChartDemoi("Pie Chart 
piechartdemo1.pack(); 
RefineryUtilities.centerFrameOnScreen(piechartdemo1); 
piechartdemo1.setVisible(true); 





5.10.3 # PieChartDemo2.java 
功能 : 

“取出 “片区 显示 。 

效果 : 


: Pie Chart Demo 2 FEER 


Seven (0% 
percent) 


Six (15% percent) 


Five (9% percent) 


Pie Chart Demo 2 


\ One (34% 
E i percent) 


Four(14% m al 
percent) 
Three (21% 
percent) 


One @ Two € Three @ Four @ Five @ Six 9 Seven 





代码 : 


private Stat 
JFreeCha 
PiePlot 
pieplot. 
pieplot. 
pieplot. 
pieplot. 
pieplot. 
pieplot. 
pieplot. 
pieplot. 
pieplot. 
pieplot. 
pieplot. 
return j 


E SSS ë ë A 


程序 代码 说 明 : 


Two (8% percent) 


ic JFreeChart createChart(PieDataset piedataset) í 

rt jfreechart = ChartFactory.createPieChart("PieChart I 
pieplot = (PiePlot) jfreechart.getPlot(); 
setSectionPaint("One", new Color(160, 160, 255)); 
setSectionPaint("Two", new Color(128, 128, 223)); 
setSectionPaint("Three", new Color(96, 96, 191)); 
setSectionPaint("Four", new Color(64, 64, 159)); 
setSectionPaint("Five", new Color(32, 32, 127)); 
setSectionPaint("Six", new Color(0, ©, 111)); 
setNoDataMessage("No data available"); 
setExplodePercent("Two", 0.5); 

setLabelGenerator(new StandardPieSectionLabelGenerator | 
setLabelBackgroundPaint(new Color(220, 220, 220)); 
setLegendLabelToolTipGenerator(new StandardPieSectionLé 
freechart; 





e setSectionPaint("One", new Color(160, 160, 255)) : 设置 某 个 片区 


的 填充 颜色 。 


提示 信息 。 


第 一 个 参数 为 片区 的 标识 ， 第 二 个 参数 为 色 值 。 


setNoDataMessage("No data available") : 设置 dataset 为 null 时 显示 的 


setLabelGenerator(new StandardPieSectionLabelGenerator("{0}({2} 


: 设置 标签 显示 的 格式 。 


ERG. 


setLabelBackgroundPaint(new Color(220, 220, 220)) : 设置 标签 的 背 


setLegendLabelToolTipGenerator(new StandardPieSectionLabelGeneré 


ERP ib ARE Y BEBE SA BU Fr RMT. 
e pieplot.setExplodePercent("Two", 0.5) : 将 第 2 个 片区 取出 显示 。 后 面 


一 个 参数 是 取出 的 距离 ， 是 一 个 比例 数 。 


5.10.4 Zi PieChartDemo3.java 


功能 : 
显示 了 dataset 为 空 时 ， 设 置 的 提示 信息 。 
效果 : 


£ Pie Chart Demo 3 


Pie Chart Demo 3 


没有 有 戏 的 数据 显示 ! 





代码 : 


private static JFreeChart createChart(PieDataset piedataset) { 
JFreeChart jfreechart = ChartFactory.createPieChart("Pie Chart 
null, true, true, false); 
PiePlot pieplot = (PiePlot) jfreechart.getPlot(); 
pieplot.setNoDataMessage ("AA MAE v mU); 
pieplot.setNoDataMessageFont(new Font ("黑体 "，2,，20)); 
pieplot.setNoDataMessagePaint(Color.red); 
return jfreechart; 


E — — 
程序 代码 说 明 : 


e setNoDataMessage(" 没 有 有 效 的 数据 显示 !") : 设置 提示 信息 内 容 。 

e setNoDataMessageFont(new Font("Serif", 2, 10)) : 设置 提示 信息 的 
字体 和 大 小 。 

e setNoDataMessagePaint(Color.red) : 设置 提示 信息 字体 的 颜色 。 





5.10.5 Zi PieChartDemo4.java 


功能 : 


JFreeChart 开发 者 指南 


带 有 按钮 的 图 表 ， 通 过 对 dataset 的 排序 ， 可 以 改变 片区 的 位 置 。 
效果 : 


= Pie Chart Demo 4 


Pie Chart Demo 4 














€ Section A € Section B ® Section C © Section D € Section E © Section F 





By Key By Value Random 





代码 : 
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public void actionPerformed(ActionEvent actionevent) { 
String string = actionevent.getActionCommand(); 
if ("BY_KEY".equals(string)) { 
if (!ascendingByKey) í 
dataset.sortByKeys(SortOrder.ASCENDING); 
ascendingByKey - true; 
) else { 
dataset.sortByKeys(SortOrder.DESCENDING); 
ascendingByKey - false; 


} 
} else if ("BY_VALUE".equals(string)) { 

if (!ascendingByValue) { 
dataset.sortByValues(SortOrder .ASCENDING) ; 
ascendingByValue = true; 

} else { 
dataset.sortByValues(SortOrder .DESCENDING) ; 
ascendingByValue = false; 


J 
) else if ("RANDOM".equals(string)) ( 

ArrayList arraylist = new ArrayList(dataset.getKeys()); 

Collections.shuffle(arraylist); 

DefaultPieDataset defaultpiedataset = new DefaultPieDatasel 

Iterator iterator - arraylist.iterator(); 

while (iterator.hasNext()) { 
Comparable comparable - (Comparable) iterator.next(); 
defaultpiedataset.setValue(comparable, dataset 
.getValue(comparable)); 

} 

PiePlot pieplot = (PiePlot) chart.getPlot(); 

pieplot.setDataset(defaultpiedataset); 

dataset - defaultpiedataset; 





程序 代码 说 明 : 


e dataset.sortByKeys(SortOrder.ASCENDING); 通过 片区 的 关键 值 进行 升序 
排序 。 

e dataset.sortByValues(SortOrder.DESCENDING); 通过 片区 的 值 进行 降序 
排序 。 


5.10.6 # PieChartDemo5.java 

功能 : 

右边 两 个 饼 图 为 原形 的 ， 而 左边 两 个 为 椭圆 形 的 。 
效果 : 


JFreeChart 开发 者 指南 


2 Pie Chart Demo 5 


Chart 1 Chart 2 


setCircular(true); setCircular(false); 




















Chart 3 Chart 4 


setCirculartrue); E setCirculafalse); 








代码 : 
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public static JPanel createDemoPanel() { 

JPanel jpanel = new JPanel(new GridLayout(2, 2)); 

DefaultPieDataset defaultpiedataset = new DefaultPieDataset(); 

defaultpiedataset.setValue("Section 1", 23.3); 

defaultpiedataset.setValue("Section 2", 56.5); 

defaultpiedataset.setValue("Section 3", 43.3); 

defaultpiedataset.setValue("Section 4", 11.1); 

// 

JFreeChart jfreechart = ChartFactory.createPieChart("Chart 1", 
defaultpiedataset, false, false, false); 

jfreechart.addSubtitle(new TextTitle("setCircular(true);", new 
"Dialog", 0, 12))); 

PiePlot pieplot = (PiePlot) jfreechart.getPlot(); 

pieplot.setCircular(true); 

// 

JFreeChart jfreechart 0 = ChartFactory.createPieChart("Chart : 
defaultpiedataset, false, false, false); 

jfreechart 0 .addSubtitle(new TextTitle("setCircular(false);", 
new Font("Dialog", ©, 12))); 

PiePlot pieplot 1 = (PiePlot) jfreechart 0 .getPlot(); 

pieplot 1 .setCircular(false); 

// 

JFreeChart jfreechart 2 = ChartFactory.createPieChart3D("Chart 
defaultpiedataset, false, false, false); 

jfreechart 2 .addSubtitle(new TextTitle("setCircular(true);", r 
"Dialog", 0, 12))); 

PiePlot3D pieplot3d = (PiePlot3D) jfreechart_2_.getPlot(); 

pieplot3d.setForegroundAlpha(0.6F); 

pieplot3d.setCircular(true); 

// 

JFreeChart jfreechart 3 = ChartFactory.createPieChart3D("Chart 
defaultpiedataset, false, false, false); 

jfreechart_3_.addSubtitle(new TextTitle("setCircular(false);", 
new Font("Dialog", 0, 12))); 

PiePlot3D pieplot3d 4 = (PiePlot3D) jfreechart 3 .getPlot(); 

pieplot3d 4 .setForegroundAlpha(0.6F); 

pieplot3d 4 .setCircular(false); 

jpanel.add(new ChartPanel(jfreechart)); 

jpanel.add(new ChartPanel(jfreechart 0 )); 

jpanel.add(new ChartPanel(jfreechart 2 )); 

jpanel.add(new ChartPanel(jfreechart 3 )); 

jpanel.setPreferredSize(new Dimension(800, 600)); 

return jpanel; 





程序 代码 说 明 : 


e pieplot.setCircular(true) : 设置 饼 图 为 圆 形 。 
e jpanel.add 方法 可 以 添加 多 个 图 形 的 panel 


JFreeChart 开发 者 指南 


5.10.7 类 PieChartDemo6.java 


功能 : 


显示 人 饼 图 对 需 值 和 null 值 的 处 理 。 


效果 : 


? Pie Chart Demo 6 


Pie Chart 1 


Ignore nulls: false; Ignore zeros: false; 
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Pie Chart 3 


Ignore nulls: false; ignore zeros: true; 


代码 : 





5.10 实例 讲解 


Pie Chart 2 


Ignore nulls: true; Ignore zeros: false; 


Pie Chart 4 


Ignore nulls: true; Ignore zeros: true; 


= 





67 


public static JPanel createDemoPanel() { 

JPanel jpanel = new JPanel(new GridLayout(2, 2)); 
JFreeChart jfreechart = createChart("Pie Chart 1", createDatase 
Font font = new Font("Dialog", 0, 12); 
jfreechart.addSubtitle(new TextTitle( 

"Ignore nulls: false; Ignore zeros: false;", font)); 
JFreeChart jfreechart 0 = createChart("Pie Chart 2", createDal 
jfreechart 0 .addSubtitle(new TextTitle( 

"Ignore nulls: true; Ignore zeros: false;", font)); 

PiePlot pieplot = (PiePlot) jfreechart 0 .getPlot(); 
pieplot.setIgnoreNullValues(true); 
pieplot.setlIgnoreZeroValues(false); 

JFreeChart jfreechart 1 = createChart("Pie Chart 3", createDat 
jfreechart 1 .addSubtitle(new TextTitle( 

"Ignore nulls: false; Ignore zeros: true;", font)); 

PiePlot pieplot 2 = (PiePlot) jfreechart 1 .getPlot(); 

pieplot 2 .setlIgnoreNullValues(false); 

pieplot 2 .setIgnoreZeroValues(true); 

JFreeChart jfreechart 3 = createChart("Pie Chart 4", createDal 
jfreechart 3 .addSubtitle(new TextTitle( 

"Ignore nulls: true; Ignore zeros: true;", font)); 

PiePlot pieplot 4 - (PiePlot) jfreechart 3 .getPlot(); 
pieplot 4 .setIgnoreNullvalues(true); 

pieplot 4 .setIgnoreZeroValues(true); 

jpanel.add(new ChartPanel(jfreechart)); 

jpanel.add(new ChartPanel(jfreechart 0 )); 
jpanel.add(new ChartPanel(jfreechart 1 )); 
jpanel.add(new ChartPanel(jfreechart 3 )); 

return jpanel; 





} 
AEO Oo O 
程序 代码 说 明 : 
e pieplot.setIgnoreNullValues(true) : 设置 饼 图 忽略 null 值 ， 即 是 null 值 
将 不 显示 。 
e pieplot.setIgnoreZeroValues(false); 设置 饼 图 不 忽略 需 值 。 即 图 表 中 
Eras fa. 


5.10.8 # PieChartDemo7.java 
功能 : 

图 表 能 够 旋转 ， 标 签 也 随 之 移动 。 

效果 : 


' Pie Chart Demo 7 
Pie Chart Demo 7 


Section 9 = 11% | — — — — —4À 
Section 8 = 11% 


Section 7 = 3% | —— 
Section 6 = 6*6 


/ Section 10 = 11% 
Section 11 = 8*6 


Section 4= 1% 4 Section 0 = 1*6 
Section 3 = 8% 2f ~ Section 1= 10% 
[Section 2 = 1%) 











代码 : 


public static JPanel createDemoPanel() { 

PieDataset piedataset = createDataset(14); 

JFreeChart jfreechart = ChartFactory.createPieChart("Pie Chart 
piedataset, false, true, false); 

jfreechart.setBackgroundPaint(new Color(222, 222, 255)); 

PiePlot pieplot - (PiePlot) jfreechart.getPlot(); 

pieplot.setBackgroundPaint(Color.white); 

pieplot.setCircular(true); 

pieplot.setLabelGenerator(new StandardPieSectionLabelGenerator | 
"{0} = (2)", NumberFormat.getNumberInstance(), NumberFormat 
.getPercentInstance())); 

pieplot.setNoDataMessage("No data available"); 

ChartPanel chartpanel = new ChartPanel(jfreechart); 

chartpanel.setPreferredSize(new Dimension(500, 270)); 

Rotator rotator - new Rotator(pieplot); 

rotator.start(); 

return chartpanel; 


KI aw] 
程序 代码 说 明 : 
e 使 用 Rotator 对 象 ， 旋 转 饼 图 。 代 码 如 上 。 





5.10.9 类 PieChartDemo8.java 
功能 : 

编写 自 定 义 标 签 产生 器 ， 将 Two 标签 不 显示 。 
效果 : 


' Pie Chart Demo 8 同上 回回 
Pie Chart Demo 8 








代码 : 


private static JFreeChart createChart(PieDataset piedataset) { 
JFreeChart jfreechart = ChartFactory.createPieChart("Pie Chart 
piedataset, false, true, false); 
PiePlot pieplot = (PiePlot) jfreechart.getPlot(); 
pieplot.setLabelGenerator(new CustomLabelGenerator()); 
return jfreechart; 
} 
static class CustomLabelGenerator implements PieSectionLabelGenerat 
public String generateSectionLabel(PieDataset piedataset, 
Comparable comparable) { 
String string = null; 
if (piedataset != null && !comparable.equals("Two") ) 
string = comparable.toString(); 
return string; 
} 
public AttributedString generateAttributedSectionLabel( 
PieDataset piedataset, Comparable comparable) { 
Object object - null; 
String string - comparable.toString(); 
String string O = (string + " : " + String.valueOf(piedat: 
.getValue(comparable))); 
AttributedString attributedstring = new AttributedString(s! 
attributedstring.addAttribute(TextAttribute.WEIGHT, 
TextAttribute.WEIGHT BOLD, 0, string.length() - 1); 
return attributedstring; 





程序 代码 说 明 : 


e HÆR CustomLabelGenerator ， 必 须 实 现 接 


[] PieSectionLabelGenerator 。 


5.10.10 # PieChart3DDemo1.java 


功能 : 
3D 效 果 的 饼 图 。 
效果 : 


! Pie Chart 3D Demo 1 FEER 
Pie Chart 3D Demo 1 


€ Java @ Visual Basic ^ C/C++ © PHP ® Perl 





代码 : 


private static JFreeChart createChart(PieDataset piedataset) í 

JFreeChart jfreechart = ChartFactory.createPieChart3D( 
"Pie Chart 3D Demo 1", piedataset, true, true, false); 

PiePlot3D pieplot3d = (PiePlot3D) jfreechart.getPlot(); 
pieplot3d.setStartAngle(180.0); 
pieplot3d.setDirection(Rotation.CLOCKWISE); 
pieplot3d.setForegroundAlpha(0.5F); 
pieplot3d.setNoDataMessage("No data to display"); 
return jfreechart; 


程序 代码 说 明 : 


e 使 用 chartFactory 的 方法 createPieChart3D 创建 3D 效 果 的 饼 图 。 

e setStartAngle(180.0) : 设置 旋转 和 角度。 

e setDirection(Rotation.CLOCKWISE) : 设置 旋转 方 
向 ， Rotation.CLOCKWISE 为 顺 时 针 。 

e setForegroundAlpha(9.5F) : 设置 图 表 透 明 图 0.0~1.0 范 围 。0.0 为 完全 透 
明 ，1.0 为 完全 不 透明 。 


5.10.11 X MultiplePieChartDemo1.java 

功能 : 

使 用 CategoryDataset 数 据 集 ， 在 一 个 图 表 上 产生 多 个 饼 图 。 
效果 : 


` Multiple Pie Chart Demo 1 


Multiple Pie Chart 








€ Sales/Q1 @ Sales/Q2 @ Sales/O3 Sales/Q4 





fa: 
private static CategoryDataset createDataset() { 
double[][] ds = { { 3.0, 4.0, 3.0, 5.0 }, { 5.0, 7.0, 6.0, 8.0 
{ 5.0, 7.0, Double.NaN, 3.0 }, { 1.0, 2.0, 3.0, 4.0 }, 


{ 2.0, 3.0, 2.0, 3.0 } }; 
CategoryDataset categorydataset = DatasetUtilities 
.createCategoryDataset("Region ", "Sales/Q", ds); 
return categorydataset; 





程序 代码 说 明 : 
e 创建 CategoryDataset 的 方法 。 


private static JFreeChart createChart(CategoryDataset categorydata: 

JFreeChart jfreechart = ChartFactory.createMultiplePieChart( 
"Multiple Pie Chart", categorydataset, TableOrder.BY ROW, 1 

MultiplePiePlot multiplepieplot = (MultiplePiePlot) jfreechart 
JFreeChart jfreechart © = multiplepieplot.getPieChart(); 
PiePlot pieplot = (PiePlot) jfreechart 0 .getPlot(); 
pieplot.setLabelGenerator(new StandardPieSectionLabelGenerator | 
pieplot.setLabelFont(new Font("SansSerif", 0, 8)); 
pieplot.setInteriorGap(0.3); 
return jfreechart; 








} 
«| = 
程序 代码 说 明 : 
e 使 用 chartFactory 的 方法 createMultiplePieChart() 创建 多 个 饼 图 的 图 
=. 


e multiplepieplot.getPieChart() : 获得 单个 饼 图 的 图 表 。 


6 直方 条 形 图 (Bar Charts) 


6.1 简介 


本 章 详 细 介 绍 了 使 用 JFreeChart 创 建 直 方 条 形 图 的 过 程 。 开 始 我 们 先 用 一 个 简单 的 
直方 条 形 图 例子 进行 说 明 ， 然 后 进一步 深入 了 解 JFreeChart 为 直方 条 形 图 提供 的 定 
要 


。 堆栈 式 直 方 条 形 图 

e 时 序数 据 的 条 形 直 方 图 

e 柱状 图 
本 章 结束 之 后 ， 我 们 将 会 对 JFreeChart 支 持 直 方 条 形 图 创建 的 特点 有 个 整体 的 了 
解 。 


6.2.1 概述 
直方 条 形 图 常常 被 用 来 显示 表 列 数据 。 如 下 表 ， 为 一 个 简单 的 两 行 、 三 列 数据 。 
表 6.1 
Colnums1 Colnums2 Colnums3 
Row1 1.0 5.0 3.0 
Row2 2.0 3.0 2.0 


在 JFreeChart 里 ， 这 个 表格 数据 封装 为 一 个 dataset 数 据 对 象 ， 每 列 标题 为 一 个 种 
类 ， 每 行为 一 个 系列 。 每 行 标题 为 一 个 系列 名 称 (或 者 系列 关键 值 ) 。 直 方 条 形 图 
展现 的 数据 图 如 图 6.2. 


= Simple Bar Chart FEER) 
Simple Bar Chart 





Column 1 Column 2 Column 3 








category 
图 6.2 简单 的 直方 条 形 图 (参见 : BarExample1.java) 


在 这 个 图 表 的 实例 中 ， 我 们 可 以 看 到 JFreeChart 将 每 列 数据 ( 即 一 个 种 类 ) 组 合 在 
一 起 。 而 且 对 每 行 数据 〈 即 每 个 系列 ) 使 用 各 种 颜色 高 之 显示 。 图 表 的 图 例 将 颜色 
和 系列 的 名 称 /关键 值 对 应 起 来 。 





6.2.2 创 一 个 dataset 


创建 直方 条 形 图 的 第 一 步 就 是 创建 一 个 合适 的 dataset 数 据 集 。JFreeChart 为 直方 条 
形 图 提供 的 访问 表 列 数据 的 一 系列 方法 ， 必 须 符 合 接口 CategoryDataset 定 义 。 


JFreeChart 中 提供 了 一 个 便利 的 实 tl ee [185 3€ 5j 
DefaultCategoryDataset。 下 面 显 示 我 们 如 何 使 用 这 个 类 来 封装 表 6.1 数 据 。 代 码 如 
下 : 


private CategoryDataset createDataset() { 
DefaultCategoryDataset dataset = new DefaultCategoryDataset(); 


dataset.addValue(1.0, "Row 1", "Column 1"); 
dataset.addValue(5.0, "Row 1", "Column 2"); 
dataset.addValue(3.0, "Row 1", "Column 3"); 
dataset.addValue(2.0, "Row 2", "Column 1"); 
dataset.addValue(3.0, "Row 2", "Column 2"); 
dataset.addValue(2.0, "Row 2", "Column 3"); 
return dataset; 
} 
‘| mE 





6.2.3 创建 一 个 chart 图 表 


接 下 来 就 是 要 创建 一 个 JFreeChart 的 实例 ， 使 用 上 面 提供 的 dataset 数 据 集 画 
方 条 形 图 。 简 单 的 ， 我 们 使 用 ChartFactory 类 来 创建 这 个 JFreeChart 实 例 。 代 码 如 
F: 


private JFreeChart createChart(CategoryDataset dataset) { 
JFreeChart chart = ChartFactory.createBarChart( 
"BarChartDemo", // chart title 
"Category", // domain axis label 
"Value", // range axis label 
dataset, // data 
PlotOrientation.VERTICAL, // orientation 
true, // include legend 
true, // tooltips? 
false // URLS? 
); 


return chart; 


CreateBarChart() 的 大 部 分 参数 是 比较 容易 理解 的 ， 但 其 中 一 部 分 还 需要 进一步 说 
明 。 


e 图 显示 的 方向 可 以 是 水 平 的 ， 还 是 可 以 是 垂直 的 。 

e 图 表 的 信息 提示 ， 是 否 要 添加 ， 有 一 个 标志 来 控 和 上 面 的 例子 中 ， 我 们 
将 这 个 标识 设置 为 ttue， 因 此 当 我 们 在 一 个 swing 应 用 窗口 显示 这 个 图 表 时 ， 我 
们 会 看 到 这 个 信息 提示 。 

e URLs 标 志 ， 设 置 为 false。 


我 们 完成 这 个 直方 条 形 图 后 ， 我 们 将 会 过 头 来 ， 仔 细 看 看 ChartFactory 类 在 后 台 做 
了 写 什 么 。 





6.2.4 显示 该 chart 图 表 


为 了 完成 我 们 的 第 一 个 直方 条 形 图 实例 ， 我 们 将 JFreeChart 实 例 传 给 一 个 
ChartPanel 对 象 ， 然 后 在 一 个 Swing 应 用 窗口 上 显示 该 实例 。 全 部 的 代码 如 下 : 


import java.awt.Dimension; 
import org.jfree.chart.ChartFactory; 
import org.jfree.chart.ChartPanel; 
import org.jfree.chart.JFreeChart; 
import org.jfree.chart.plot.PlotOrientation; 
import org.jfree.data.category.DefaultCategoryDataset; 
import org.jfree.ui.ApplicationFrame; 
import org.jfree.ui.RefineryUtilities; 
JESSE 
* A simple demonstration application showing how to create a bar ct 
“y 
public class BarExample1 extends ApplicationFrame { 

jee 

* Creates a new demo instance. 

* 

* (param title 

* the frame title. 

Au 

public BarExamplei(String title) í 

super(title); 
DefaultCategoryDataset dataset - new DefaultCategoryDatasel 


dataset.addValue(1.0, "Row 1", "Column 1"); 
dataset.addValue(5.0, "Row 1", "Column 2"); 
dataset.addValue(3.0, "Row 1", "Column 3"); 
dataset.addValue(2.0, "Row 2", "Column 1"); 
dataset.addValue(3.0, "Row 2", "Column 2"); 
dataset.addValue(2.0, "Row 2", "Column 3"); 
JFreeChart chart - ChartFactory.createBarChart( 


"Bar Chart Demo", // chart 
// title 
"Category", // domain axis label 
"Value", // range axis label 
dataset, // data 
PlotOrientation.VERTICAL, // orientation 
true, // include legend 
true, // tooltips? 
false // URLs? 
); 
ChartPanel chartPanel - new ChartPanel(chart, false); 
chartPanel.setPreferredSize(new Dimension(500, 270)); 
setContentPane(chartPanel); 
n 
JESS 
£ Starting point for the demonstration application. 
* 
* @param args 
* ignored. 
Ua 
public static void main(String[] args) { 


BarExamplei demo = new BarExamplei("Bar Demo 1"); 
demo.pack(); 
RefineryUtilities.centerFrameOnScreen(demo) ; 
demo.setVisible(true); 








完成 这 些 代码 后 ， 运 行 代码 ， 将 会 显示 如 6.2 图 的 界面 。 


6.3 ChartFactory # 


在 上 面 的 实例 代码 中 ， 我 们 使 用 ChartFactory 类 来 组 装 一 个 JFreeChart 实 例 来 显示 
一 个 直方 条 形 图 。 下 面 我 们 更 仔细 的 看 一 下 该 类 是 如 何 工作 的 ， 因 此 我 们 可 以 看 到 
直方 条 形 图 更 多 底层 的 框架 结构 。 理 解 底层 结构 的 关键 是 能 定制 图 表 的 外 观 。 下 面 
是 ChartFactory 方 法 createBarChart() 方 法 部 分 代码 : 


CategoryAxis categoryAxis = new CategoryAxis(categoryAxisLabel); 
ValueAxis valueAxis = new NumberAxis(valueAxisLabel); 
BarRenderer renderer = new BarRenderer(); 


CategoryPlot plot = new CategoryPlot(dataset, categoryAxis, valueA 
renderer); 

plot.setOrientation(orientation); 
JFreeChart chart = new JFreeChart(title, JFreeChart.DEFAULT TITLE I 


s == == a = LLL ZI] 
以 下 就 是 代码 所 做 的 工作 。 


e 我 们 的 直方 条 形 图 有 两 个 轴 ， 一 个 轴 显 示 dataset (CategoryAxis) 的 种 类 ， 另 
一 个 是 显示 带 有 数据 (NumberAxis) 刻度 的 数据 轴 。 上 面 代 码 中 代码 1、2 行 
建立 了 这 两 个 轴 ， 轴 的 标签 是 createBarChart() 方 法 传人 的 。 

e 第 三 行 ， 创 建 了 一 个 BarRender 一 一 该 类 为 每 一 个 数据 项 目 画 直方 图 。 该 
render 人 处 理 大 部 分 画图 工作 ， 我 们 后 续 代 码 也 会 看 到 可 以 使 用 另 一 个 类 型 的 
render 替 换 现 有 的 render， 来 改变 图 表 的 整个 外 观 。 

e Dataset、axes 和 render 都 由 CategorryPlot 来 管理 ，CategorryPlot 系 统 组 件 之 
间 的 大 部 分 交互 工作 。 当 我 们 定制 一 个 图 表 时 ， 我 们 经 常 需要 先 获得 整个 图 表 
plot、renderer 和 dataset 的 引用 。 在 代码 的 第 四 行 ， 创 建 了 一 个 plot， 然 后 其 他 
组 件 对 它 进行 赋值 。 

e 最 后 ， 在 JFreeChart 实 例 中 ， 这 个 plot 用 指定 的 标题 被 封装 。JFreeChart 类 提 
供 了 上 比较 高 层次 的 访问 图 表 。 但 在 这 个 plot 鲁 思 图 表 就 大 部 分 被 定义 出 来 了 

(Plot 管 理 很 多 对 象 ， 例 如 axes、dataset 和 renderer) 。 


图 表 的 内 部 结构 基本 上 是 由 上 面 的 知识 理论 组 成 。 在 后 续 的 章节 ， 我 们 会 逐渐 学 习 
更 多 的 定制 我 们 图 表 的 方法 。 








6.4 直方 条 形 图 的 简单 定制 


调用 JFreeChart 和 CategoryPlot 类 方法 可 以 进行 一 些 简 单 的 直方 图 表 外 观 的 修改 。 
例如 ， 改 变 图 表 和 区 域 的 背景 颜色 代码 如 下 : 


chart.setBackgroundPaint(Color.white); 

CategoryPlot plot - (CategoryPlot) chart.getPlot(); 
plot.setBackgroundPaint(Color.lightGray); 
plot.setRangeGridlinePaint(Color.white); 


该 片段 代码 (摘自 BarExample2.java 类 ) 显示 了 改变 图 表 的 背景 颜色 、 获 得 图 表 的 
plot (Ki) 的 引用 ， 并 且 进 行 了 修改 一 一 效果 如 图 6.3. 





2 Bar Demo DER) 
Bar Chart Demo 





Column 1 Column 2 Column 3 


Category 
BRow1 E Row 2 


图 6.3 一 个 直方 条 形 图 (参考 : BarExample2.java) 


区 域 Plot 的 引用 (CategoryPlot) 是 必须 的 一 一 转换 类 型 也 是 非常 安全 的 ， 因 为 我 
们 知道 该 图 表 类 型 使 用 CategoryPlot。JFreeChart 使 用 不 同 的 区 域 类 型 (比如 
PiePlot, XYPlot) 控制 不 同类 型 的 图 表 。 我 们 必须 将 plot 的 引用 转化 成 图 表 响 应 的 
类 型 ， 因 为 基本 类 Plot 仅 仅 定义 了 一 些 通用 的 属性 和 方法 。 随 着 对 JFreeChart 了 解 
的 加 深 ， 我 们 将 学 习 每 一 种 图 表 使 用 的 不 同 的 plot 子 类 。 


在 我 们 的 例子 中 ， 我 们 使 用 plot 的 引用 来 改变 水 平 轴 的 网 格 线 颜色 。 看 一 下 
CategoryPlot 类 的 API 文 件 ， 就 会 看 到 我 们 能 够 修改 的 地 方 。 





6.5 定制 外 观 


回顾 6.3 节 内 容 ，CategoryPlot 管 理 这 一 个 BarRenderer 的 实例 renderer。 如 果 我 们 
想 获 得 这 个 renderer 的 引用 ， 大 量 的 定制 选择 项 会 变 得 有 效 。 


6.5.1 直方 条 形 图 颜色 
改变 图 表 中 每 个 系列 直方 图 的 颜色 ， 使 用 如 下 代码 : 


BarRenderer renderer = (BarRenderer) plot.getRenderer(); 
renderer.setSeriesPaint(0, Color.gray); 
renderer.setSeriesPaint(1, Color.orange); 
renderer.setDrawBarOutline(false); 


运行 上 面 代码 显示 的 结果 如 下 图 6.4. 注 意 setSeriesPaint () 方法 是 在 抽象 
AbstractRenderer 基 类 里 面 定 义 的 所 以 ， 我 们 可 以 在 任何 类 型 的 renderer 里 面 
使 用 。 
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图 6.4 一 个 直方 条 形 图 (参考 : BarExample3.java) 





6.5.2 种 类 里 直方 条 形 图 之 间 的 空间 


此 外 ，renderer 还 可 以 控制 每 个 种 类 中 直方 条 形 图 之 间 的 间距 。 因 此 我 们 可 以 在 同 
一 个 种 类 中 将 空间 完全 去 掉 ， 代 码 如 下 : 


BarRenderer renderer = (BarRenderer) plot.getRenderer(); 
renderer.setItemMargin(0.0); 





JFreeChart 开发 者 指南 


代码 显示 的 结果 如 图 6.5 所 示 。 


= Bar Demo 1 


Bar Chart Demo 


Column 1 Column 2 Column3 


Category 
图 6.5 一 个 直方 条 形 图 (参考 : BarExample4.java) 


注意 条 形 图 看 上 去 有 点 变 宽 主要 是 因为 JFreeChart 分 配 空间 时 ， 分 配给 种 类 条 
形 图 之 间 的 间距 的 尺度 比较 少 ， 所 以 看 上 去 就 显得 有 点 长 宽 了 。 








6.5 定制 外 观 83 


6.6 示例 代码 解读 


6.6.1 体会 

与 饼 图 的 数据 集 不 同 之 处 在 于 

人 饼 图 数据 集 是 key/value 二 维 数据 (PieDataset) 。 而 直方 条 形 图 需要 三 维 数据 
(CategoryDataset) 。 


6.6.2 X BarChartDemo1.java 

功能 

一 个 简单 的 直方 条 形 图 。 使 用 GradientPaint 实 例 对 象 为 每 一 个 系列 修改 renderer 
效果 : 
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代码 : 


public class BarChartDemo1 extends ApplicationFrame í 
private static final long serialVersionUID = 1L; 
public BarChartDemo1i(String string) í 

super(string); 

JPanel jpanel = createDemoPanel(); 
jpanel.setPreferredSize(new Dimension(500, 270)); 
setContentPane(jpanel); 


j 

private static CategoryDataset createDataset() ( 
String string - "First"; 
String string O = "Second"; 
String string 1 = "Third"; 


String string 2 = "Category 1"; 


} 


String string_3_ 
String string 4_ "Category 3"; 

String string 5 "Category 4"; 

String string 6 = "Category 5"; 

DefaultCategoryDataset defaultcategorydataset = new Default 
defaultcategorydataset.addValue(1.0, string, string_2_); 


"Category 2"; 


defaultcategorydataset.addValue(4.0, string, string_3_); 

defaultcategorydataset.addValue(3.0, string, string_4_); 

defaultcategorydataset.addValue(5.0, string, string_5_); 

defaultcategorydataset.addValue(5.0, string, string_6_); 

defaultcategorydataset.addValue(5.0, string O , string 2 ), 
defaultcategorydataset.addValue(7.0, string O , string 3 ), 
defaultcategorydataset.addValue(6.0, string 0 , string 4 ), 
defaultcategorydataset.addValue(8.0, string 0 , string 5 ), 
defaultcategorydataset.addValue(4.0, string O , string 6 ), 
defaultcategorydataset.addValue(4.0, string 1 , string 2 ), 
defaultcategorydataset.addValue(3.0, string 1 , string 3 ), 
defaultcategorydataset.addValue(2.0, string 1 , string 4 ), 
defaultcategorydataset.addValue(3.0, string 1 , string 5 ), 
defaultcategorydataset.addValue(6.0, string 1 , string 6 ), 


return defaultcategorydataset; 


private static JFreeChart createChart(CategoryDataset category: 


JFreeChart jfreechart = ChartFactory.createBarChart("Bar Cl 
"Category", "Value", categorydataset, PlotOrientation.\ 
true, true, false); 

jfreechart.setBackgroundPaint(Color.WHITE); 

CategoryPlot categoryplot = (CategoryPlot) jfreechart.getP- 

categoryplot.setBackgroundPaint(Color.lightGray); 

categoryplot.setDomainGridlinePaint(Color.white); 
categoryplot.setDomainGridlinesVisible(true); 
categoryplot.setRangeGridlinePaint(Color.white); 

// 刻 度 轴 刻度 设置 

NumberAxis numberaxis = (NumberAxis) categoryplot.getRange/ 

numberaxis.setStandardTickUnits(NumberAxis.createIntegerTi: 

//renderer zi 

BarRenderer barrenderer = (BarRenderer) categoryplot.getRer 

barrenderer.setDrawBarOutline(false) ;// BARBARA W 

GradientPaint gradientpaint = new GradientPaint(0.0F, 0.0F, 
0.0F, 0.0F, new Color(0, ©, 64)); 


GradientPaint gradientpaint_7_ = new GradientPaint(0.0F, 0 
Color.green, 0.0F, 0.0F, new Color(0, 64, 0)); 
GradientPaint gradientpaint 8 = new GradientPaint(0.0F, 0 


Color.red, 0.0F, 0.0F, new Color(64, ©, 0)); 
barrenderer.setSeriesPaint(0, gradientpaint); 
barrenderer.setSeriesPaint(1, gradientpaint 7 ); 
barrenderer.setSeriesPaint(2, gradientpaint 8 ); 

// 设 置 种 类 标签 旋转 的 角度 ， 逆 时 针 旋 转 
CategoryAxis categoryaxis = categoryplot.getDomainAxis(); 
categoryaxis.setCategoryLabelPositions(CategoryLabelPositic 

.createUpRotationLabelPositions(Math.PI / 6)); 
return jfreechart; 


public static JPanel createDemoPanel() { 
JFreeChart jfreechart = createChart(createDataset()); 
return new ChartPanel(jfreechart); 


public static void main(String[] strings) { 
BarChartDemo1 barchartdemoi = new BarChartDemoi("Bar Chart 
barchartdemo1.pack(); 
RefineryUtilities.centerFrameOnScreen(barchartdemo1); 
barchartdemo1.setVisible(true); 


) 


«| m 








程序 代码 说 明 : 


Main() 方法 执行 直方 条 形 图 。 编 写 方 法 与 饼 图 一 样 。 

e BarChartDemo1 构造 画 数 中 创 了 一 个 JPanel， 并 设置 大 小 。 

e createDemoPanel() 方法 创建 了 一 个 JPanel， 并 且 在 该 panel 上 创建 了 直方 
条 形 图 。 

e createDataset() 方法 创建 了 数据 集 。 类 型 为 CategoryDataset。 注 意 数 据 
集 为 三 维 数据 。 与 饼 图 不 同 。 

e 使 用 ChartFactory.createBarChart() 方法 创建 直方 条 形 图 

e jfreechart.setBackgroundPaint(Color.WHITE) : 设置 图 表 的 背景 颜 
色 。 

e categoryplot.setBackgroundPaint(Color.lightGray) : 设置 直方 条 形 
ANAS me. 

e setDomainGridlinePaint (Color.whites) :设置 垂直 格 线 的 颜色 。 默 认 
不 可 见 。 

e setRangeGridlinePaint(Color.white) : 设置 水 平 格 线 的 颜色 。 默 认可 
见 。 

e setStandardTickUnits(NumberAxis.createIntegerTickUnits()) : Z 
置 数据 轴 的 刻度 递 进 范 围 。 

e GradientPaint 类 用 来 设置 渐变 色 。 

e categoryaxis.setCategoryLabelPositions() :设置 标签 文字 旋转 的 角 


度 。 


6.6.3 X BarChartDemo2.java 
功能 : 

显示 水 平 的 直方 条 形 图 。 

效果 : 
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代码 : 


private static CategoryDataset createDataset() { 
double[][] ds = { { 1.0, 43.0, 35.0, 58.0, 54.0, 77.0, 71.0, 8: 
{ 54.0, 75.0, 63.0, 83.0, 43.0, 46.0, 27.0, 13.0 }, 
{ 41.0, 33.0, 22.0, 34.0, 62.0, 32.0, 42.0, 34.0 } }; 
return DatasetUtilities.createCategoryDataset("Series ", "Fact 
} 
private static JFreeChart createChart(CategoryDataset categorydata: 
JFreeChart jfreechart = ChartFactory.createBarChart("Bar Chart 
"Category", "Score (%)", categorydataset, 
PlotOrientation.VERTICAL, true, true, false); 
jfreechart.setBackgroundPaint(Color.white); 
CategoryPlot categoryplot = (CategoryPlot) jfreechart.getPlot(. 
categoryplot.setBackgroundPaint(Color.lightGray); 
categoryplot.setRangeGridlinePaint(Color.white); 
categoryplot.setRangeAxisLocation(AxisLocation.BOTTOM OR LEFT), 
NumberAxis numberaxis = (NumberAxis) categoryplot.getRangeAxis! 
numberaxis.setRange(0.0, 100.0); 
numberaxis.setStandardTickUnits(NumberAxis.createIntegerTickUn: 
BarRenderer barrenderer = (BarRenderer) categoryplot.getRendere 
barrenderer.setDrawBarOutline( false) ; 
barrenderer 
.setLegendItemToolTipGenerator(new StandardCategorySeriesLé 
"Tooltip: {0}")); 
return jfreechart; 


E 
程序 代码 说 明 : 
e 数据 集 的 创建 另 一 种 方式 ， 使 用 二 维 数组 。 





7 折线 图 


7.1 简介 


本 章 讲 述 了 JFreeChart 创 建 折线 图 的 内 容 。 我 们 可 以 使 用 CategoryDataset 或 
XYDataset 数 据 集 接口 创建 折线 图 。 


7.2 使 用 categoryDataset 数 据 集 创建 折线 


7.2.1 概述 


使 用 CategoryDataset 创 建 的 折线 图 将 每 个 数据 点 (种 类 ， 值 ) 使 用 一 条 直线 连接 
起 来 。 本 章 讲 的 一 个 简单 应 用 产生 如 下 界面 ， 如 图 7.1 : 


Java Standard Class Library 


Number of Classes By Release 


Class Count 








JDK 1.0 JDK 1.1 JDK 1.2 JDK 1.3 JDK 1.4 JDK 1.5 





Source: Java In A Nutshell (5th Edition) by David Flanagan (O'Reilly) 


E 7.1 一 个 简单 的 折线 图 


全 部 的 代码 简 JFreeChart 开 发 指南 一 并 下 载 的 demo (参考 : 
LineChartDemo1.java) 。 


7.2.2 CategoryDataset 


正如 其 他 图 表 一 样 ， 创 建 折线 图 的 第 一 步 是 创建 第 一 个 dataset。 在 本 例子 中 ， 使 用 
DefaultCategoryDataset， 代 码 如 下 : 


private static CategoryDataset createDataset() { 
DefaultCategoryDataset defaultcategorydataset = new DefaultCate 
defaultcategorydataset.addValue(212.0, "Classes", "JDK 1.0"); 
defaultcategorydataset.addValue(504.0, "Classes", "JDK 1.1"); 


了 
defaultcategorydataset.addValue(1520.0, "Classes", "JDK 1.2"); 
defaultcategorydataset.addValue(1842.0, "Classes", "JDK 1.3"); 
defaultcategorydataset.addValue(2991.0, "Classes", "JDK 1.4"); 
defaultcategorydataset.addValue(3500.0, "Classes", "JDK 1.5"); 


return defaultcategorydataset; 


«j — kk 








注意 : 你 可 以 使 用 任何 实现 Category 接 口 的 数据 集 。 


7.2.3 创建 图 表 
ChartFactory 类 提供 了 一 个 便利 的 方法 createLineChart() 创 建 折线 图 。 代 码 如 下 : 


JFreeChart jfreechart = ChartFactory.createLineChart( 
"Java Standard Class Library",// 图 表 标 题 
null, // 主轴 标签 
"Class Count",// 范围 轴 标 签 
categorydataset, // 数据 集 
PlotOrientation.VERTICAL,// 方向 
false, // 是 否 包 含 图 例 
true, // 提示 信息 是 否 显示 
false// 是 否 使 用 urls 
); 


该 方法 构建 了 一 个 带 有 标题 、 图 例 、 和 相应 的 数 轴 和 心态 提示 产生 器 的 JFreeChart 
对 象 。 创 建 Dataset 数 据 集 的 过 程 见 上 节 。 


7.2.4 定制 图 表 


折线 图 表 将 使 用 大 部 分 缺 省 的 属性 来 进行 初始 化 。 当 然 了 ， 我 们 也 可 以 随意 修改 折 
线 图 的 属性 ， 来 改变 我 们 图 表 的 外 观 。 在 本 例 中 ， 我 们 通过 下 面 的 方式 定制 折线 
图 : 


在 图 表 上 添加 两 个 副标题 ; 

图 表 的 背景 颜色 设 成 白色 ; 

图 区 背景 颜色 设 成 亮 灰 色 ; 

网 格 线 颜 色 改 变 成 白色 ; 

范围 轴 修 改 成 仅 显 示 整 数 数值 ; 
renderer 使 用 白色 填充 的 形状 。 


首先 ， 将 副标题 添加 在 缺 省 的 位 置 〈( 主 标题 下 方 ) ， 代 码 如 下 : 


jfreechart.addSubtitle(new TextTitle("Number of Classes By Release' 


第 二 个 副标题 加 入 了 一 些 额 外 的 代码 ， 来 改变 字体 ， 并 放置 在 图 表 的 下 方 ， 并 且 和 售 
右 对 其 ， 代 码 如 下 : 





TextTitle texttitle = (new TextTitle("Source: Java In A Nutshell (! 
texttitle.setFont(new Font("SansSerif", 0, 10)); 
texttitle.setPosition(RectangleEdge. BOTTOM) ; 
texttitle.setHorizontalAlignment(HorizontalAlignment.RIGHT); 
jfreechart.addSubtitle(texttitle); 


«| B 








改变 图 表 的 背景 颜色 非常 简单 ， 因 为 JFreeChart 类 就 有 设置 背景 颜色 的 属性 。 代 码 
如 下 : 


// 改 变 图 表 的 背景 颜色 
jfreechart.setBackgroundPaint(Color.white); 


如 果 改 变 其 他 属性 的 ， 则 需要 首先 获得 图 表 CategoryPlot 对 象 的 引用 ， 然 后 对 该 引 
用 进行 相应 属性 的 设置 。 获 得 对 象 引 用 的 代码 如 下 : 


CategoryPlot categoryplot = (CategoryPlot) jfreechart.getPlot(); 


f&i FH CategoryPlot;& EA XB ES zm ERES 29 AKE, kBMBAMB 75 HER 25 n 
F: 


categoryplot.setBackgroundPaint(Color.lightGray); 
categoryplot.setRangeGridlinePaint(Color.white); 


图 区 负责 在 图 表 上 画 出 数据 和 轴 。 其 中 一 部 分 工作 由 renderer 来 完成 ， 我 们 可 以 通 
过 getRender() 来 获得 一 个 renderer。renderer 维 护 大 部 分 与 图 表 内 数据 项 的 显示 相 
关 的 属性 。 代 码 如 下 : 


LineAndShapeRenderer renderer = (LineAndShapeRenderer) categoryplot 
renderer.setShapesVisible(true); 
renderer.setDrawOutlines(true); 
renderer.setUseFillPaint(true); 


一 i 


同时 图 区 也 管理 着 图 表 所 有 的 轴 。 在 本 实例 中 ， 修 改 范 围 轴 以 便 范 围 轴 的 刻度 标签 
显示 为 整数 值 。 





NumberAxis rangeAxis = (NumberAxis) categoryplot.getRangeAxis(); 
rangeAxis.setStandardTickUnits(NumberAxis.createIntegerTickUnits()_ 


" = 


定制 图 表 还 有 很 多 其 他 的 方式 。 具 体 的 内 容 详 见 本 文档 相关 章节 ，API 文 档 以 及 源 
代码 实例 。 
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7.2.5 程序 的 全 部 代码 


Ve RE su CUN 
* LineChartDemo1.java 


* 


* (C) Copyright 2002-2005, by Object Refinery Limited. 
* 


a 

package demo; 

import java.awt.BasicStroke; 

import java.awt.Color; 

import java.awt.Dimension; 

import java.awt.Font; 

import java.awt.geom.Ellipse2D; 

import java.net.URL; 

import javax.swing.ImageIcon; 

import javax.swing.JPanel; 

import org.jfree.chart.ChartFactory; 
import org.jfree.chart.ChartPanel; 

import org.jfree.chart.JFreeChart; 

import org.jfree.chart.axis.NumberAxis; 
import org.jfree.chart.plot.CategoryPlot; 
import org.jfree.chart.plot.PlotOrientation; 


import org.jfree.chart.renderer.category.LineAndShapeRenderer; 


import org.jfree.chart.title.TextTitle; 

import org.jfree.data.category.CategoryDataset; 

import org.jfree.data.category.DefaultCategoryDataset; 
import org.jfree.ui.ApplicationFrame; 

import org.jfree.ui.HorizontalAlignment; 

import org.jfree.ui.RectangleEdge; 

import org.jfree.ui.RefineryUtilities; 

public class LineChartDemo1 extends ApplicationFrame { 


[fre 
* 


ay 


private static final long serialVersionUID = -6354350604313079 


/* synthetic */static Class class$demo$LineChartDemo1; 


public LineChartDemoi(String string) { 
super(string); 
JPanel jpanel - createDemoPanel(); 
jpanel.setPreferredSize(new Dimension(500, 270)); 
setContentPane(jpanel); 


j 


private static CategoryDataset createDataset() ( 


DefaultCategoryDataset defaultcategorydataset = new Default 


defaultcategorydataset.addValue(212.0, "Classes", 
defaultcategorydataset.addValue(504.0, "Classes", 
defaultcategorydataset.addValue(1520.0, "Classes", 
defaultcategorydataset.addValue(1842.0, "Classes", 
defaultcategorydataset.addValue(2991.0, "Classes", 
defaultcategorydataset.addValue(3500.0, "Classes", 
return defaultcategorydataset; 


"JDK 1.0' 
"JDK 1.1' 
PID KS Te 
"JDK 1. 
"JDK 1.: 
"JDK 1.5 


} 


private static JFreeChart createChart(CategoryDataset categoryc 
JFreeChart jfreechart = ChartFactory.createLineChart( 


"Java Standard Class Library",// 图 表 标 题 


null, // 主轴 标签 


"Class Count",// 范围 轴 标 签 


categorydataset, 


// 数据 集 


PlotOrientation.VERTICAL,// 方向 
false, // 是 否 包 含 图 例 

true, // 提示 信息 是 否 显示 

false// 是 否 使 用 ur1s 


DE 
// 添加 主 标 题 


jfreechart.addSubtitle(new TextTitle("Number of Classes By 


TextTitle texttitle 


(new TextTitle( 


"Source: Java In A Nutshell (5th Edition) by David Flar 
texttitle.setFont(new Font("SansSerif", ©, 10)); 
texttitle.setPosition(RectangleEdge.BOTTOM); 
texttitle.setHorizontalAlignment(HorizontalAlignment.RIGHT: 
jfreechart.addSubtitle(texttitle); 


// 改变 图 表 的 背景 颜色 


jfreechart.setBackgroundPaint(Color.white); 


CategoryPlot categoryplot - 


(CategoryPlot) jfreechart.getP- 


categoryplot.setBackgroundPaint(Color.lightGray); 
categoryplot.setRangeGridlinePaint(Color.white); 
categoryplot.setRangeGridlinesVisible(false); 


URL url = (class$demo$LineChartDemo1 


null ? class$demo$l 


class$demo$LineChartDemo1).getClassLoader().getResou!: 
"OnBridgeiismall.png"); 


if (url != null) { 


Imagelcon imageicon - 


new ImageIcon(url); 


jfreechart.setBackgroundImage(imageicon.getImage()); 
categoryplot.setBackgroundPaint(new Color(0, 0, 0, 0)), 


} 


NumberAxis numberaxis 


= (NumberAxis) categoryplot.getRange/ 


numberaxis.setStandardTickUnits(NumberAxis.createIntegerTi: 


LineAndShapeRenderer 
.getRenderer(); 


lineandshaperenderer. 
lineandshaperenderer. 
lineandshaperenderer. 
lineandshaperenderer. 
lineandshaperenderer. 
lineandshaperenderer. 
lineandshaperenderer. 


10.0, 10.0)); 
LineAndShapeRenderer 
.getRenderer(); 


lineandshaperenderer = (LineAndShapeRe 
setShapesVisible(true); 
setDrawOutlines(true); 
setUseFillPaint(true); 
setBaseFillPaint(Color.white); 
setSeriesStroke(0, new BasicStroke(3.t( 
setSeriesOutlineStroke(0, new BasicSti 
setSeriesShape(0, new Ellipse2D.Double 


renderer = (LineAndShapeRenderer) cate 


renderer.setShapesVisible(true); 
renderer.setDrawOutlines(true); 
renderer.setUseFillPaint(true); 


return jfreechart; 


public static JPanel createDemoPanel() { 
JFreeChart jfreechart = createChart(createDataset()); 
return new ChartPanel(jfreechart); 

} 

public static void main(String[] strings) { 
LineChartDemo1 linechartdemoi = new LineChartDemo1( 
"JFreeChart - Line Chart Demo 1"); 
linechartdemo1.pack(); 
RefineryUtilities.centerFrameOnScreen(linechartdemo1); 
linechartdemoi1.setVisible(true); 


/* synthetic */ 
static Class class$(String string) { 
Class var. class; 
try { 
var class = Class.forName(string); 
) catch (ClassNotFoundException classnotfoundexception) { 
throw new NoClassDefFoundError(classnotfoundexception. ¢ 


} 


return var_class; 





7.3 使 用 XYDataset 数 据 集 创建 折线 


7.3.1 概述 


折线 图 也 可 以 使 用 XYDataset 数 据 集 ， 使 用 一 条 直线 将 相 邻 的 点 (x, y) 点 连接 起 
来 。 本 章 介 绍 的 一 个 使 用 XYDataset 数 据 集 创建 折线 图 的 简单 实例 ， 如 下 图 7.2 所 
7Ivo 
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图 7.2 一 个 简单 的 基于 XYDataset 数 据 集 的 折线 图 (参考 : LineChartDemo2 java) 
7.3.2 XYDataset 


对 于 该 图 表 来 说 ， 使 用 的 数据 集 是 XYSeriesCollection (当然 我 们 可 以 使 用 实现 
XYDataset 接 口 的 其 他 数据 集 ) 。 出 于 独立 演示 的 目 点 ， 我 们 创建 的 dataset 代 码 如 
下 : 


private static XYDataset createDataset() { 
XYSeries xyseries = new XYSeries("First"); 
xyseries.add(1.0, 1.0); 


xyseries.add(2.0, 4.0); 
xyseries.add(3.0, 3.0); 
xyseries.add(4.0, 5.0); 
xyseries.add(5.0, 5.0); 
xyseries.add(6.0, 7.0); 
xyseries.add(7.0, 7.0); 


xyseries.add(8.0, 8.0); 

XYSeries xyseries 0 = new XYSeries("Second"); 
Xyseries 0 .add(1.0, 5.0); 
xyseries 0 .add(2.0, 7.0); 
Xyseries 0 .add(3.0, 6.0); 
xyseries 0 .add(4.0, 8.0); 
xyseries 0 .add(5.0, 4.0); 
Xyseries 0 .add(6.0, 4.0); 
Xyseries 0 .add(7.0, 2.0); 
xyseries O .add(8.0, 1.0); 
XYSeries xyseries 1 = new XYSeries("Third"); 
xyseries 1 .add(3.0, 4.0); 

Xyseries 1 .add(4.0, 3.0); 

Xxyseries 1 .add(5.0, 2.0); 

xyseries 1 .add(6.0, 3.0); 

xyseries 1 .add(7.0, 6.0); 

Xyseries 1 .add(8.0, 3.0); 

xyseries 1 .add(9.0, 4.0); 

Xyseries 1 .add(10.0, 3.0); 

XYSeriesCollection xyseriescollection = new XYSeriesCollectioni 
xyseriescollection.addSeries(xyseries); 
xyseriescollection.addSeries(xyseries 0 ); 
xyseriescollection.addSeries(xyseries 1 ); 

return xyseriescollection; 





注意 : 每 个 系列 必须 有 x 值 (不 是 必须 有 y 值 ) ， 并 且 该 系列 独立 于 其 他 系列 。 数 据 
集 可 以 接受 一 个 y 值 为 null 的 值 。 当 图 表 遇 到 null 值 时 ， 连 接线 不 被 画 出 ， 该 系列 的 
连 线 不 会 连续 。 出 现下 图 7.3 类 型 。 
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图 7.3 有 一 个 y 值 为 null 时 ， 图 表 显 示 断 续 。 


7.3.3 创建 图 表 


ChartFactory 类 提供 了 一 个 便利 的 方法 createXYLineChart() 创 图 表 : 


JFreeChart jfreechart = ChartFactory.createXYLineChart( 
"Line Chart Demo 2", // chart title 
"X", // x axis label 
"Y", // y axis label 
xydataset, // data 
PlotOrientation.VERTICAL, 
true, // include legend 
true, // tooltips 
false // urls 
); 


上 面 方法 构建 了 一 个 JFreeChart 对 象 ， 该 对 象 具 有 一 个 标题 、 图 例 和 相关 轴 的 图 区 
及 renderer。 数 据 集 使 用 上 节 我 们 创建 的 数据 集 。 


7.3.4 定制 图 表 


图 表 将 使 用 大 部 分 缺 省 的 属性 进行 初始 化 设置 。 当 然 了 ， 我 们 也 可 以 随意 修改 这 些 
属性 ， 来 改变 我 们 图 表 的 外 观 。 在 本 实例 中 ， 设 置 的 几 个 属性 如 下 : 


设置 图 表 的 背景 颜色 

设置 图 区 的 背景 颜色 

设置 轴 的 平移 值 

设置 主轴 和 范围 轴 网 格 线 颜 色 

修改 renderer 改 变 连 线 点 的 形状 

范围 轴 刻 度 的 设置 ， 以 便 显 示 整 数值 。 


改变 图 表 背 景 颜 色 非 常 简单 。 代 码 如 下 : 


// 改 变 图 表 的 背景 颜色 
jfreechart.setBackgroundPaint(Color.white); 


改变 图 区 背景 颜色 、 轴 平移 、 网 格 线 颜色 ， 需 要 使 用 plot 图 区 对 象 的 一 个 引用 来 修 
改 。 图 片 对 象 需要 转化 成 XYPlot 对 象 ， 主 要 是 因为 我 们 可 以 访问 更 多 更 具体 的 图 区 
方法 。 代 码 如 下 : 


XYPlot xyplot = (XYPlot) jfreechart.getPlot(); 
xyplot.setBackgroundPaint(Color.lightGray); 
xyplot.setAxisOffset(new RectangleInsets(5.0, 5.0, 5.0, 5.0)); 
xyplot.setDomainGridlinePaint(Color.white); 
xyplot.setRangeGridlinePaint(Color.white); 


修改 renderer 来 显示 连 线 之 间 的 形状 。 代 码 如 下 : 


XYLineAndShapeRenderer xylineandshaperenderer = (XYLineAndShapeRenc 
xylineandshaperenderer.setShapesVisible(true); 
xylineandshaperenderer.setShapesFilled(true); 





最 后 就 是 修改 范围 轴 。 我 们 将 默认 刻度 值 (允许 显示 小 数 ) 改 成 只 显示 整数 的 刻度 
值 。 代 码 如 下 : 


NumberAxis numberaxis = (NumberAxis) xyplot.getRangeAxis(); 
numberaxis.setStandardTickUnits(NumberAxis.createIntegerTickUnits(: 


TEJ) 


参考 源 代 码 、Javadoc 的 API 文 档 以 及 其 他 相关 XYPlot 的 定制 内 容 ， 来 学 习 更 多 的 细 
节 。 





8 时 序 图 


8.1 简介 


时 序 图 类 似 于 折线 图 ， 唯 一 不 后 
SK S Z ; 不 E] E^ E3 、 E 
“ Ec nodus c Os Ossa AS 


8.2 创建 时 序 图 


8.2.1 概述 


时 序 图 表 的 确 是 一 个 使 用 XYDataset 数 据 集 的 折线 图 。 不 同 点 就 是 再 主轴 上 X 轴 值 
显示 的 是 日 期 。 本 章 讲 述 的 一 个 简单 应 用 如 下 图 8.1 所 示 
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图 8.1 一 个 简单 的 时 序 图 表 (参考 : TimeSeriesDemo1.java) 。 
上 图 实例 代码 参见 类 TimeSeriesDemo1.java。 





8.2.2 日 期 还 是 数字 ? 


创建 序 图 使 用 的 数据 集 是 XYDataset。 接 口 不 能 有 返回 日 期 类 型 以 外 的 方法 。 那 么 
JFreeChart 是 如 何 创 建 时 序 图 表 的 呢 ? 


数据 集 返 回 的 x 值 是 基本 的 double 类 型 ， 但 这 个 值 通过 一 种 特殊 的 方式 来 进行 转译 
成 日 期 该 数 是 反映 了 一 个 从 1970/1/1 起 计算 的 一 个 毫秒 级 值 ( 译 码 过 程 使 用 
java.util.Data 类 计算 ) 。 


具体 的 轴 类 (DateAxis) 将 毫秒 级 数据 转化 成 日 期 ， 并 作为 需要 返回 该 值 ， 将 数值 
作为 主轴 刻度 显示 出 来 。 
8.2.3 数据 集 


演示 的 本 实例 ， 数 据 使 用 的 是 一 个 TimeSeriesCollection 对 象 (我 们 可 以 是 任何 
XYDataset 接 口 的 实现 ) 。 代 码 如 下 : 





private static XYDataset createDataset() { 
TimeSeries timeseries = new TimeSeries( 
"L&G European Index Trust", 
(class$org$jfree$data$time$Month == null ? (class$org$j free 
class$org$jfree$data$time$Month) ); 
timeseries.add(new Month(2, 2001), 181.8); 
timeseries.add(new Month(3, 2001), 167.3); 
timeseries.add(new Month(4, 2001), 153.8); 
timeseries.add(new Month(5, 2001), 167.6); 
timeseries.add(new Month(6, 2001), 158.8); 
timeseries.add(new Month(7, 2001), 148.3); 
timeseries.add(new Month(8, 2001), 153.9); 
timeseries.add(new Month(9, 2001), 142.7); 
timeseries.add(new Month(10, 2001), 123.2); 
timeseries.add(new Month(11, 2001), 131.8); 
timeseries.add(new Month(12, 2001), 139.6); 
timeseries.add(new Month(1, 2002), 142.9); 
timeseries.add(new Month(2, 2002), 138.7); 
timeseries.add(new Month(3, 2002), 137.3); 
timeseries.add(new Month(4, 2002), 143.9); 
timeseries.add(new Month(5, 2002), 139.8); 
timeseries.add(new Month(6, 2002), 137.0); 
timeseries.add(new Month(7, 2002), 132.8); 
TimeSeries timeseries O = new TimeSeries( 
"L&G UK Index Trust", 
(class$org$jfree$data$time$Month == null ? (class$org$jfree 
class$org$jfree$data$time$Month) ) ; 
timeseries 0 .add(new Month(2, 2001), 129.6); 
timeseries 0 .add(new Month(3, 2001), 123.2); 
timeseries 0 .add(new Month(4, 2001), 117.2); 
timeseries 0 .add(new Month(5, 2001), 124.1); 
timeseries 0 .add(new Month(6, 2001), 122.6); 
timeseries 0 .add(new Month(7, 2001), 119.2); 
timeseries 0 .add(new Month(8, 2001), 116.5); 
timeseries 0 .add(new Month(9, 2001), 112.7); 
timeseries 0 .add(new Month(10, 2001), 101.5); 
timeseries 0 .add(new Month(11, 2001), 106.1); 
timeseries 0 .add(new Month(12, 2001), 110.3); 
timeseries 0 .add(new Month(1, 2002), 111.7); 
timeseries 0 .add(new Month(2, 2002), 111.0); 
timeseries 0 .add(new Month(3, 2002), 109.6); 
timeseries 0 .add(new Month(4, 2002), 113.2); 
timeseries 0 .add(new Month(5, 2002), 111.6); 
timeseries 0 .add(new Month(6, 2002), 108.8); 
timeseries 0 .add(new Month(7, 2002), 101.6); 
TimeSeriesCollection timeseriescollection = new TimeSeriesColl: 
timeseriescollection.addSeries(timeseries); 
timeseriescollection.addSeries(timeseries O ); 
return timeseriescollection; 








实例 中 ， 系 列 包含 了 每 月 的 数据 。 尽 管 如 此 ， 仍 然 使 用 TimeSeries 类 来 显示 间隔 的 
时 间 值 (年 、 日 、 小 时 等 ) 。 


8.2.4 构建 图 表 


使 用 ChartFactory 类 提供 的 便利 方法 createTimeSeriesChart() 创 建 图 表 ， 代 码 如 
下 : 


JFreeChart jfreechart = 


ChartFactory.createTimeSeriesChart( 
"Legal & General Unit Trust Prices", // title 


"Date", // x-axis label 


"Price Per Unit", // y-axis label 
xydataset, // data 


true, // create legend? 
true, // generate tooltips? 
false // generate URLs? 


); 
该 方法 构建 了 一 个 带 有 有 标题、 图例、 相应 轴 的 区 域 和 展示 器 的 JFreeChart 对 象 。 使 
用 的 数据 集 见 上 一 节 内 容 。 


8.2.5 定制 图 表 


图 表 的 大 部 分 属性 使 用 了 缺 省 的 值 进行 初始 化 。 当 然 ， 我 们 可 以 随时 修改 这 些 属性 
入 忆 玉 改变 我 们 图表 的 外 观 展现 ， 在 本 实例 中 ， 修改 的 几 个 属性 如 下 : 


e 修改 renderer， 改 变 每 个 数据 点 显示 的 系列 形状 ， 数 据点 之 间 的 折线 除外 。 
e 主轴 的 数据 格式 进行 格式 化 后 显示 。 


修改 renderer 需 要 一 下 两 个 步骤 : 获得 


获得 renderer 引 用 和 将 renderer 对 象 转化 成 
XYLineAndShapeRenderer 类 型 。 代 码 如 下 : 


XYItemRenderer xyitemrenderer 


= xyplot.getRenderer(); 
if (xyitemrenderer instanceof XYLineAndShapeRenderer) { 


XYLineAndShapeRenderer xylineandshaperenderer = (XYLineAndShape 
xylineandshaperenderer.setBaseShapesVisible(true); 
xylineandshaperenderer.setBaseShapesFilled(true); 

} 





最 后 


， 将 格式 化 的 数据 传 给 主轴 ， 以 改变 显示 。 代 码 如 下 : 


DateAxis dateaxis = (DateAxis) xyplot.getDomainAxis(); 
dateaxis.setDateFormatOverride(new SimpleDateFormat ("MMM-yyyy")) 
F] 








当 设 置 了 Dataaxis 时 ， 系 统 将 自动 选择 一 个 DataTickUnit 来 显示 主轴 刻度 。 但 系统 
将 使 用 上 面 我 们 格式 化 的 数据 来 显示 ， 而 不 是 系统 默认 的 格式 。 


8.2.6 全 部 代码 
文档 的 全 部 代码 如 下 : 


/* TimeSeriesDemoi - Decompiled by JODE 
* Visit http://jode.sourceforge.net/ 
Lut 
package demo; 
import java.awt.Color; 
import java.awt.Dimension; 
import java.text.SimpleDateFormat; 
import javax.swing.JPanel; 
import org.jfree.chart.ChartFactory; 
import org.jfree.chart.ChartPanel; 
import org.jfree.chart.JFreeChart; 
import org.jfree.chart.axis.DateAxis; 
import org.jfree.chart.plot.XYPlot; 
import org.jfree.chart.renderer.xy.XYLineAndShapeRenderer; 
import org.jfree.data.time.Month; 
import org.jfree.data.time.TimeSeries; 
import org.jfree.data.time.TimeSeriesCollection; 
import org.jfree.data.xy.XYDataset; 
import org.jfree.ui.ApplicationFrame; 
import org.jfree.ui.RectangleInsets; 
import org.jfree.ui.RefineryUtilities; 
public class TimeSeriesDemo1 extends ApplicationFrame í 
private static final long serialVersionUID - -5412286370956646: 
/* synthetic */ 
static Class class$org$jfree$data$time$Month; 
public TimeSeriesDemoi(String string) í 
super(string); 
XYDataset xydataset = createDataset(); 
JFreeChart jfreechart = createChart(xydataset); 
ChartPanel chartpanel = new ChartPanel(jfreechart, false); 
chartpanel.setPreferredSize(new Dimension(500, 270)); 
chartpanel.setMouseZoomable(true, false); 
setContentPane(chartpanel); 
j 
private static JFreeChart createChart(XYDataset xydataset) { 
JFreeChart jfreechart = ChartFactory.createTimeSeriesChart | 
"Legal & General Unit Trust Prices", // title 
"Date", // x-axis label 
"Price Per Unit", // y-axis label 
xydataset, // data 
true, // create legend? 
true, // generate tooltips? 
false // generate URLS? 


); 


jfreechart.setBackgroundPaint(Color.white); 
XYPlot xyplot - (XYPlot) jfreechart.getPlot(); 
xyplot.setBackgroundPaint(Color.lightGray); 
xyplot.setDomainGridlinePaint(Color.white); 
xyplot.setRangeGridlinePaint(Color.white); 
xyplot.setAxisOffset(new RectangleInsets(5.0, 5.0, 5.0, 5.( 
xyplot.setDomainCrosshairVisible(true); 
xyplot.setRangeCrosshairVisible(true); 
org.jfree.chart.renderer.xy.XYItemRenderer xyitemrenderer : 
.getRenderer(); 
if (xyitemrenderer instanceof XYLineAndShapeRenderer) ( 
XYLineAndShapeRenderer xylineandshaperenderer = (XYLint 
xylineandshaperenderer.setBaseShapesVisible(true); 
xylineandshaperenderer.setBaseShapesFilled(true); 
} 
DateAxis dateaxis = (DateAxis) xyplot.getDomainAxis(); 
dateaxis.setDateFormatOverride(new SimpleDateFormat ("MMM-y\ 
return jfreechart; 
} 
private static XYDataset createDataset() { 
TimeSeries timeseries = new TimeSeries( 
"L&G European Index Trust", 
(class$org$jfree$data$time$Month == null ? (class$org$: 
class$org$jfree$data$time$Month) ); 
timeseries.add(new Month(2, 2001), 181.8); 
timeseries.add(new Month(3, 2001), 167.3); 
timeseries.add(new Month(4, 2001), 153.8); 
timeseries.add(new Month(5, 2001), 167.6); 
timeseries.add(new Month(6, 2001), 158.8); 
timeseries.add(new Month(7, 2001), 148.3); 
timeseries.add(new Month(8, 2001), 153.9); 
timeseries.add(new Month(9, 2001), 142.7); 
timeseries.add(new Month(10, 2001), 123.2) 
timeseries.add(new Month(11, 2001), 131.8); 
timeseries.add(new Month(12, 2001), 139.6); 
timeseries.add(new Month(1, 2002), 142.9); 
timeseries.add(new Month(2, 2002), 138.7); 
timeseries.add(new Month(3, 2002), 137.3); 
timeseries.add(new Month(4, 2002), 143.9); 
timeseries.add(new Month(5, 2002), 139.8); 
timeseries.add(new Month(6, 2002), 137.0); 
timeseries.add(new Month(7, 2002), 132.8); 
TimeSeries timeseries O = new TimeSeries( 
"L&G UK Index Trust", 
(class$org$jfree$data$time$Month == null ? (class$org$: 
class$org$jfree$data$time$Month)); 
timeseries 0 .add(new Month(2, 2001), 129.6); 
timeseries 0 .add(new Month(3, 2001), 123.2); 
timeseries 0 .add(new Month(4, 2001), 117.2); 
timeseries 0 .add(new Month(5, 2001), 124.1); 
timeseries 0 .add(new Month(6, 2001), 122.6); 
timeseries 0 .add(new Month(7, 2001), 119.2); 
timeseries 0 .add(new Month(8, 2001), 116.5); 


x. 


timeseries 0 .add(new Month(9, 2001), 112.7); 
timeseries 0 .add(new Month(10, 2001), 101.5); 
timeseries 0 .add(new Month(11, 2001), 106.1); 
timeseries 0 .add(new Month(12, 2001), 110.3); 
timeseries 0 .add(new Month(1, 2002), 111.7); 
timeseries 0 .add(new Month(2, 2002), 111.0); 
timeseries 0 .add(new Month(3, 2002), 109.6); 
timeseries 0 .add(new Month(4, 2002), 113.2); 
timeseries 0 .add(new Month(5, 2002), 111.6); 
timeseries 0 .add(new Month(6, 2002), 108.8); 
timeseries 0 .add(new Month(7, 2002), 101.6); 
TimeSeriesCollection timeseriescollection = new TimeSeries( 
timeseriescollection.addSeries(timeseries); 
timeseriescollection.addSeries(timeseries 0 ); 
return timeseriescollection; 

} 

public static JPanel createDemoPanel() { 
JFreeChart jfreechart = createChart(createDataset()); 
return new ChartPanel(jfreechart); 

Jj; 

public static void main$(String[] strings) { 
TimeSeriesDemoi timeseriesdemo1 = new TimeSeriesDemo1( 

"Time Series Demo 1"); 

timeseriesdemo1.pack(); 
RefineryUtilities.centerFrameOnScreen(timeseriesdemo1); 
timeseriesdemo1.setVisible(true); 

} 

public static void main(String[] args) { 
main$(args); 

J 


/* synthetic */ 
static Class class$(String string) { 
Class var_class; 
try { 
var_class = Class.forName(string); 
} catch (ClassNotFoundException classnotfoundexception) { 
throw new NoClassDefFoundError(classnotfoundexception. ¢ 


} 


return var_class; 





9 定制 图 表 (Customising Charts) 


9.1 简介 


JFreeChart 的 设计 的 定制 功能 是 非常 灵活 的 。 我 们 可 以 使 用 非常 多 的 属性 来 设置 我 
们 图 表 的 外 观 。 本 章 将 详细 介绍 一 些 图 表 通 用 的 定制 技术 。 


9.2 图 表 属 性 


9.2.1 概述 


我 们 可 以 使 用 JFreeChart 类 方法 从 更 高 的 层次 来 定制 我 们 图 表 的 外 观 。 可 控制 的 属 
性 有 : 

e 图 表 的 边框 

e 图 表 的 标题 和 副标题 

e 图 表 的 背景 颜色 和 图 片 

e 使 用 绘制 建议 (Rendering Hints) 画图 表 ， 该 属性 有 是 否 反 锯齿 功能 。 


在 下 面 的 章节 中 将 详细 描述 这 些 内 容 。 
9.2.2 图 表 边 框 
JFreeChart 可 以 在 图 表 的 外 转 画 出 一 个 边框 。 默 认 状 态 下 ，JFreeChart 是 不 画 出 边 


框 的 ， 但 我 们 可 以 使 用 方法 setBorderVisible() 来 设置 。 边 框 的 颜色 和 线条 风格 可 使 
用 方法 setBorderPaint() 和 setBorderStroke() 来 控制 。 


注意 : a 图 表 ， 那 么 我 们 可 能 更 愿意 使 用 
Swing 提供 的 边框 。 


9.2.3 图 表 标 题 


图 表 有 一 个 标题 ， 显示 在 图 表 的 顶部 、 底 部 、 左 侧 或 右 侧 (同时 ， 我 们 也 可 以 添加 
副标题 ， 见 下 章 讲 述 ) 。 标 题 使 用 一 个 TextTitle 的 实例 对 象 。 我 们 可 以 使 用 
getTitle() 方 法 来 获得 标题 的 引用 。 


TextTitle texttitle = jfreechart.getTitle(); 


修改 标题 文本 〈 不 修改 字体 和 位 置 ) 的 代码 如 下 : 


texttitle.setText("Pie Chart Demo"); 


题 头 放置 在 图 表 的 顶部 、 底 部 、 左 侧 或 右 侧 的 设置 ， 使 用 标题 本 书 属性 设置 来 完 
成 。 下 面 代码 显示 的 是 将 标题 移植 到 图 表 的 底部 。 


texttitle.setPosition(RectangleEdge.BOTTOM) ; 


如 果 在 我 们 图 表 上 ， 我 们 不 希 示 标 题 ， 则 将 标题 设置 为 null 即 可 。 


9.2.4 副标题 


图 表 可 以 拥有 任何 数量 的 副标题 。 添 加 副标题 ， 需 要 先 创建 一 个 副标题 对 象 CE 
Title 类 的 子 类 ) ， 然 后 将 该 对 象 加 到 图 表 上 即 可 。 代 码 如 下 : 


TextTitle subtitle1 = new TextTitle("A Subtitle"); 
jfreechart.addSubtitle(subtitle1); 


我 们 可 以 在 图 表 上 添加 任何 数量 的 副标题 ， 但 是 紧急 我 们 添加 的 副标题 越 多 ， 图 表 
画图 的 区 域 就 越 小 。 
修改 一 个 已 有 的 副标题 ， 我 们 需要 先 获得 副标题 的 一 个 引用 。 代 码 如 下 : 


Title subtitle = jfreechart.getSubtitle(0); 
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我 们 可 以 使 用 setBackgroundPaint() 方 法 设置 图 表 的 背景 颜色 (注意 ， 我 们 也 可 以 
设置 我 们 图 区 的 背景 颜色 ， 这 和 与 图 表 的 背景 颜色 不 同 ) 。 例 如 : 


jfreechart.setBackgroundPaint(Color.blue); 


我 们 可 使 用 Paint 接 口 的 任何 实现 作为 背景 颜色 的 设置 参数 ， 其 中 有 Color、 
GradientPaint (渐变 颜色 ) 和 TexturePaint 等 。 代 码 如 下 : 


Paint p = new GradientPaint(0, 0, Color.white, 1000, 0, Color.greer 

jfreechart.setBackgroundPaint(p); 
He 
我 们 可 以 设置 我 们 的 背景 颜色 为 null， 这 时 推荐 使 用 一 个 背景 图 片 来 设置 我 们 的 图 


o 





9.2.6 使 用 背景 图 片 
我 们 可 以 使 用 方法 setBackgroundlmage() 来 为 我 们 的 图 表 设 置 一 幅 背 景 图 表 。 


jfreechart.setBackgroundImage(JFreeChart.INFO.getLogo()); 


默认 的 ， 图 片 充 满 图 表 的 整个 背景 ， 图 片 失真 。 但 我 们 可 以 使 用 
setBackgroundlmageAlignment() 方 法 来 改变 图 片 不 充满 整个 背景 。 代 码 如 下 : 


jfreechart.setBackgroundImageAlignment(Align.TOP LEFT); 


使 用 setBackgroundImageAlpha() 方 法 ， 我 们 可 以 控制 图 片 的 透明 度 。 如 果 我 们 希 
望 图 片 只 填充 我 们 图 表 的 区 域 (区 域 包含 轴 ) ， 那 么 我 们 需要 将 背景 图 片 添加 到 图 
表 的 图 区 。 代 码 如 下 (LAAs) : 


PiePlot pieplot = (PiePlot) jfreechart.getPlot(); 
pieplot.setBackgroundImage( JFreeChart .INFO.getLogo( ) ) 
9.2.7 Rendering Hints (绘制 建议 ) 
JFreeChart 使 用 java2D 的 APl 来 画图 表 。 在 java2D 中 的 API 中 ， 我 们 可 以 提供 绘制 


建议 让 绘制 引擎 绘 制图 表 。JFreeChart 人 允许 我 们 在 画图 表 时 ， 使 用 
setRenderingHints() 方 法 ， 将 绘制 建议 参数 传人 java2D 的 API 中 。 


JFreeChart 还 提供 了 一 个 便利 反 锯 此 开关 方法 。 当 反 锯 肯 开 关 开 时 ， 图 表 会 绘制 出 
比较 光滑 的 图 表 ， 但 是 花费 的 时 间 要 长 。 代 码 如 下 : 


jfreechart.setAntiAlias(true); 
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9.3 图 区 属性 


9.3.1 概述 


JFreeChart 类 在 绘制 图 表 时 ， 将 大 部 分 工作 交 给 了 Plot 类 (图 形 绘制 结构 ) 或 Plot 
的 子 类 。JFreeChart 类 的 getPlot() 方 法 返回 了 一 个 图 表 创 建 的 图 区 (plot) 的 引用 。 


Plot plot = jfreechart.getPlot(); 


我 们 需要 将 该 引用 转化 成 Plot 的 一 个 具体 子 类 。 例 如 : 


CategoryPlot plot = jfreechart.getCategoryPlot(); 


或 


XYPlot plot = jfreechart.getXYPlot(); 


注意 : 如 果 plot 不 是 相应 的 类 ， 则 在 转化 的 时 候 ， 会 抛 出 ClassCastException 类 型 
转制 异常 。 


9.3.2 图 区 子 类 
那么 我 们 如 何 知 道 我 们 图 表 使 用 的 Plot 是 那个 子 类 呢 ? 作为 使 用 JFreeChart 的 经 
验 ， 分 清 那些 图 表 使 用 CategoryPlot 和 那些 图 表 使 用 XYPlot 是 非常 清晰 的 。 如 果 还 


怀疑 ， 看 一 下 ChartFactory 类 的 源 代码 就 会 明白 每 个 类 型 的 图 表 是 如 何 放 在 一 起 
的 。 


9.3.3 设置 图 区 表 景 颜色 
我 们 可 以 使 用 方法 setBackgroundPaint() 设 置 图 区 的 背景 颜色 。 例 如 : 


Plot plot = jfreechart.getPlot(); 
plot .setBackgroundPaint(Color.white); 


我 们 可 使 用 Paint 接 口 的 任何 实现 作为 背景 颜色 的 设置 参数 ， 其 中 有 Color、 
GradientPaint (渐变 颜色 ) 和 TexturePaint 等 。 同 时 ， 我 们 也 可 以 设置 背景 颜色 为 
null, 


9.3.4 设置 背景 图 片 


我 们 可 以 使 用 方法 setBackgroundlmage() 为 图 区 设置 各 有 图 片 。 


Plot plot = jfreechart.getPlot(); 
plot .setBackgroundImage( JFreeChart .INFO.getLogo()); 
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景 ， 使 用 方法 是 setBackgroundlmageAlignment()。 


plot.setBackgroundImageAlignment(Align.BOTTOM_RIGHT); 


使 用 setBackgroundImageAlpha() 方 法 ， 我 们 可 以 控制 图 片 的 透明 度 。 如 果 我 们 希 
望 图 片 充 满 这 个 图 表 区 域 ， 那 么 我 们 需要 将 背景 图 片 添 加 到 JFreeChart 对 象 上 (前 
面 已 经 介绍 过 ) 。 


9.4 轴 属 性 


9.4.1 概述 


使 用 JFreeChart 创 建 的 大 部 分 图 表 都 带 有 两 个 轴 。X 轴 和 Y 轴 。 当 然 对 于 一 些 图 表 
(比如 饼 图 ) 根本 就 没有 轴 。 对 于 使 用 轴 的 图 表 来 说 ， 图 区 使 用 Axis 对 象 来 管理 
轴 。 


9.4.2 获得 轴 对 象 引用 


在 你 修改 轴 的 属性 之 前 ， 我 们 需要 先 获得 一 个 轴 的 引用 。 图 区 类 CategoryPlot 和 
XYPlot 类 有 两 个 方法 getDomainAxis() 和 getRangeAxis() 分 别 是 获得 X 轴 Y 轴 对 象 。 
这 两 个 方法 返回 了 一 个 ValueAxis 对 象 的 引用 ， 除 了 在 使 用 CategoryPlot 的 情况 下 ， 
X 轴 使 用 的 是 CategoryAxis。 代 码 如 下 : 


// get an axis reference... 

CategoryPlot plot = jfreechart.getCategoryPlot(); 
CategoryAxis domainAxis = plot.getDomainAxis(); 
// change axis properties... 
domainAxis.setLabel("Categories"); 
domainAxis.setLabelFont(someFont); 


CategoryAxis 和 ValueAxis 类 有 许多 不 同 的 子 类 。 有 时 我 们 需要 将 轴 对 象 引 用 转化 成 
具体 的 子 类 ， 为 了 获取 更 多 具体 的 属性 。 如 ， 如 果 我 们 想 获得 y 轴 为 一 个 对 象 
NumberAxis。 代 码 如 下 : 


XYPlot plot = jfreechart.getXYPlot(); 
NumberAxis rangeAxis = (NumberAxis) plot.getRangeAxis(); 
rangeAxis.setAutoRange(false); 


9.4.3 设置 轴 标 签 


我 们 使 用 方法 setLabel() 可 以 改变 轴 的 标签 。 如 果 我 们 不 想 在 图 表 的 轴 上 有 标签 ， 
那么 我 们 就 设置 为 null 即 可 。 


我 们 可 以 使 用 Axis 类 定义 的 方法 setLabelFont(), setLabelPaint(), 和 
setLabellnsets() 改 变 标签 的 字体 、 颜 色 等 内 容 。 
9.4.4 改变 周边 标签 显示 方 问 


当 图 区 在 左 侧 或 右 侧 画 一 个 轴 (水 平 轴 ) 时 ， 轴 标签 会 自动 旋转 90 度 ， 以 满足 小 空 
间 的 需要 。 如 果 我 们 希望 标签 也 水 平 ， 我 们 需要 修改 标签 的 角度 : 


XYPlot plot = jfreechart.getXYPlot(); 
ValueAxis axis = plot.getRangeAxis(); 
axis.setLabelAngle(Math.PI / 2.0); 


注意 角度 的 表示 使 用 弧度 (PI 为 180 度 ) 。 


9.4.5 隐藏 刻度 标签 
隐藏 某 个 轴 的 刻度 标签 : 


CategoryPlot plot = jfreechart.getCategoryPlot(); 
ValueAxis axis = plot.getRangeAxis(); 
axis.setTickLabelsVisible(false) ; 


对 于 CategoryAxis， 方 法 setTickLabelsVisible(false) 隐 藏 种 类 标签 。 


9.4.6 隐藏 刻度 符号 


隐藏 某 个 轴 的 刻度 符号 : 


XYPlot plot = jfreechart.getXYPlot(); 
Axis axis = plot.getDomainAxis(); 
axis.setTickMarksVisible(false); 


注意 category 轴 没有 刻度 符号 。 


9.4.7 设置 刻度 尺寸 


默认 的 ， 数 值 和 日 期 会 自动 选择 一 个 刻度 尺寸 ， 以 便 刻度 标 签 不 会 重复 显示 。 但 我 
们 也 可 以 使 用 setTickUnit() 方 法 设置 我 们 自己 的 俄 刻 度 单 位 。 


9.4.8 指定 标准 的 数值 刻度 单位 


在 NumberAxis 类 中 ， 方 法 允许 我 们 设置 我 们 自己 的 刻度 单位 蔡 代 系统 自动 选择 刻 
度 danwi 的 机 制 。 最 普通 的 点 用 就 是 我 们 有 一 个 仅仅 显示 整数 的 数 轴 。 在 实例 中 ， 
我 们 不 想 让 0.5 或 者 0.25 作 为 刻度 单位 。 在 NumberAxis 类 中 有 一 个 静态 方法 返回 一 
系列 的 标准 整数 刻度 单位 : 


XYPlot plot = jfreechart.getXYPlot(); 

NumberAxis axis = (NumberAxis) plot.getRangeAxis(); 
TickUnitSource units = NumberAxis.createIntegerTickUnits(); 
axis.setStandardTickUnits(units); 


如 果 我 们 想 控 制 标准 的 刻度 单位 时 ， 我 们 可 以 自由 定制 自己 的 TickUnits 集 合 。 


9.4.9 指定 标准 的 日 期 刻度 单位 


类 似 于 上 一 节 内 容 ，DateAxis 类 也 有 一 个 setStandardTickUnits() 方 法 ， 来 设置 我 们 
的 刻度 单位 。 方 法 createStandardDateTickUnits() 为 DateAxis 返 回 了 一 个 缺 省 的 集 
合 。 同 时 我 们 也 可 以 创建 我 们 自己 的 标准 日 期 刻度 单位 。 
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9.5 心得 体会 
9.5.1 Title 子 类 如 下 图 : 
包 图 如 下 所 示 : 


(=) £8) jfreechart-1.0.6. jar - D: \mylib\jfree 
IJ EE, META-INF 
HO org. jfree. chart 
B tt org. ] free. chart. title 
由 CompositeTitle. class 
由 DateTitle. class 
由 ImageTitle. class 
由 LegendGraphic. class 
由 LegendItemBlockContainer. class 
由 LegendTitle. class 
由 PaintScaleLegend. class 
由 TextTitle. class 


由 Title. class 
(Hoth org. jtree. chart. needle 


关系 类 图 如 下 : 














9.5.2 Plot# 
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DE jfreechart-1.0.6. jar - D: \mylib\jfres 
由 -号 META-INF 
&- H3 org. jfree. chart 










由 i» tPieLabelDistributor. cl: 
由 Üategoryllarker. class 

由 i» CategoryPlot. class 

由 ColorPalette. class 

由 CombinedDomainCategoryPlot. cla: 
由 i» CombinedDomainktYPlot. class 

由 CombinedRangeCategoryPlot. clas: 
CH fon) CombinedRangeXYPlot. class 

由 CompassPlot. class 

由 i» ContourPlot. class 

由 i» ContourPlotUtilities. class 

由 ContourValuePlot. class 

由 CrosshairState. class 

由 IatasetRenderingÜürder. class 

由 -起 DefaultDrawingSupplier. class 

< - = - 
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10 动态 图 (Dynamic Charts) 


10.1 简介 


为 了 说 明 使 用 JFreeChart 创 建 “ 动 态 " 的 图 表 ， 本 章节 阐述 了 一 个 简单 的 应 用 说 明 这 
Nit fz, 该 应 用 为 动态 刷新 JVM 内 存 显示 已 使 用 和 未 使 用 情 况 。 如 下 图 10.1 


Wemory Usage Demo 


JVM Memory Usage 


3,000,000 I 
2,000,000 





1,000,000 = C RNC 
0 = 


15:10:22.500 15:10:23.000 15:10:23.500 15:10:24.000 
Time 


- Total Memory — Free Memory 





如 图 10.1 一 个 简单 的 “动态 "实例 (参考 : MemoryUsageDemo java) 。 


10.2 知识 背景 


10.2.1 事件 监听 


JFreeChart 使 用 监听 机 制 来 响应 其 他 chart 组 件 改 变 的 响应 。 例 如 ， 不 论 数据 源 在 何 
时 发 生 更 新 ， 一 个 DatasetChangeEvent 事 件 总 被 发 送 给 已 注册 进 数 据 源 的 监听 
fuo 


响应 触发 发 生 一 系列 事件 : 


e 图 区 监听 到 数据 源 改 变 的 通知 。 如 果 需 要 更 新 轴 的 值 ， 然 后 将 
PlotChangeEvent 事 件 通 知 所 有 注册 的 监听 器 。 

e 图 表 监 听 到 图 区 更 改 事件 的 通知 ， 然 后 将 ChartChangeEvent 事 件 通知 给 所 有 
注册 的 监听 器 。 

e 最 后 ，ChartPanel 接 受到 该 面板 上 显示 的 图 表 的 更 改 事 件 ，ChartPanel 根 据 响 
应 的 事件 画 出 响应 的 图 表 一 一 完全 重新 画 ， 而 不 是 仅仅 更 新 数据 。 


所 有 图 表 或 者 其 他 子 控件 改变 发 生 的 事件 过 程 都 遵循 上 面 的 过 程 。 





10.2.2 性 能 优化 


关于 性 能 优化 ， 我 们 必须 明白 JFreeChart 不 会 产生 实时 图 表 。 每 次 数据 源 的 更 新 ， 
ChartPanel 都 需要 重新 画 全 部 的 图 表 。 


性 能 优化 通常 是 非常 困难 的 。 比如 ，JFreeChart 调 用 图 像 2D 的 API 提 取 最 新 变更 的 
点 ， 从 而 只 画 更 新 的 点 。 我 们 使 用 JFreeChart 完 成 这 个 实时 过 程 的 实例 将 限制 了 “每 
秒 产生 页 面 * 的 数量 。 产 生 数 量 的 大 小 是 否 是 一 个 撼 颈 的 关键 问题 ， 主 要 取决 我 们 我 
们 画图 表 所 依赖 的 数据 ， 应 用 的 环境 和 操作 环境 。 


10.3 实例 应 用 


10.3.1 概述 
实例 MemoryUsageDemo.java 文 档 可 以 从 下 面 的 链接 中 获得 : 


http://www.object-refinery.com/jfreechart/premium/index.html 


页 面 需要 输入 购买 JFreeChart 开 发 指南 时 需要 的 用 户 名 和 密码 。 


10.3.2 创建 一 个 dataset 


创建 的 实例 代码 数据 源 ， 包 含 了 一 个 单一 的 时 序 集合 ， 集 合 内 有 两 个 TimeSeries 对 
R (一 个 是 计算 总 内 存 ， 另 一 个 是 计算 剩余 内 存 ) o RAAT : 


this.total = new TimeSeries("Total", Millisecond.class); 
this.total.setMaximumItemAge (30000); 

this.free - new TimeSeries("Free", Millisecond.class); 
this.free.setMaximumItemAge(30000); 

TimeSeriesCollection dataset - new TimeSeriesCollection(); 
dataset.addSeries(this.total); 
dataset.addSeries(this.free); 


每 个 时 间 系 列 的 maximumltemAge 属 性 设置 为 30000 毫 秒 (30 秒 ) 。 因 此 任何 时 候 
添加 到 新 系列 的 新 数据 ， 都 是 30 秒 前 记录 的 老 数 据 。 


10.3.3 创建 一 个 图 表 
图 表 的 创建 (定制 ) 都 遵循 所 有 图 表 创建 的 标准 模式 。 创 建 动态 图 也 是 一 样 ， 没 有 


任何 特殊 的 步骤 。 除 了 我 们 将 autoRange 属 性 设置 为 true 之 外 。 同 时 ， 这 也 有 利于 
维护 图 表 使 用 的 数据 源 的 引用 。 


10.3.4 更 新 一 个 dataset 


在 本 实例 演示 中 ， 通 过 向 两 个 时 序 图 添加 的 数据 来 更 新 数据 源 ， 该 数据 的 添加 有 一 
个 独立 的 线程 Timer 管 理 。 代 码 如 下 : 


class DataGenerator extends Timer implements ActionListener { 
DataGenerator(int i) í 


sup 


er(i, 


null); 


addActionListener(this); 


public void actionPerformed(ActionEvent actionevent) { 

long 1 = Runtime.getRuntime().freeMemory(); 

long 10 = Runtime.getRuntime().totalMemory(); 
MemoryUsageDemo.this.addTotalObservation((double) 10 ); 
MemoryUsageDemo.this.addFreeObservation((double) 1); 


注意 JFreeChart 在 画图 表 和 数据 源 更 新 代码 之 间 没有 使 用 线程 同步 ， 因 此 是 不 安全 


的 。 另 一 点 需 


注意 的 是 ， 便 做 过 一 个 关于 JFreeChart 内 存 泄露 问题 的 测试 ， 将 
JFreeChart 的 实例 在 一 个 机 器 上 连续 运行 6 天 。 随 着 图 表 的 不 断 更 新 ， 我 们 就 可 以 
看 到 垃圾 收集 器 所 产生 的 影响 。 六 天 之 后 ， 发 现 总 内 存 的 使 用 量 保持 不 变 。 当 
JFreChart 产 生 并 丢弃 的 临时 对 象 (垃圾 对 象 ) 时 ， 剩 余 可 用 内 存 减 少 了 。 增 加 的 
使 用 内 存量 是 垃圾 收集 器 工作 时 所 使 用 的 。 


10.3.5 全 部 代码 
下 面 是 全 部 的 实例 代码 : 


/* MemoryUsageDemo - Decompiled by JODE 
* Visit http://jode.sourceforge.net/ 


SÅ 


package demo; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


java. 
java. 
java. 
java. 
java. 
java. 
java. 
java. 


org. 
org. 
org. 
org. 
org. 
org 
org. 
org. 
org 


awt 
awt. 
awt. 
awt. 
awt. 
awt. 
awt. 
awt. 


jfree. 
jfree. 
jfree. 
jfree. 
jfree. 
.jfree. 
jfree. 
jfree. 
.jfree. 


.BasicStroke; 


BorderLayout; 


Color; 
Font; 


event.ActionEvent; 
event.ActionListener; 
event.WindowAdapter; 
event .WindowEvent; 
javax.swing.BorderFactory; 
javax.swing. JFrame; 
javax.swing.JPanel; 
javax.swing.Timer; 


chart 


chart 
chart 


chart. 
.axis.DateAxis; 
.axis.NumberAxis; 
chart. 
chart. 
data.time.Millisecond; 
data.time.TimeSeries; 
data.time.TimeSeriesCollection; 


.ChartPanel; 


JFreeChart; 


plot.XYPlot; 
renderer.xy.XYLineAndShapeRenderer; 


import org.jfree.ui.RectangleInsets; 
public class MemoryUsageDemo extends JPanel { 
private static final long serialVersionUID = 67767128383594986- 
private TimeSeries total; 
private TimeSeries free; 
/* synthetic */ 
static Class class$org$jfree$data$time$Millisecond; 
class pataGenerator extends Timer implements ActionListener í 
private static final long serialVersionUID = 1L; 
DataGenerator(int i) í 
super(i, null); 
addActionListener(this); 


public void actionPerformed(ActionEvent actionevent) { 
long 1 = Runtime.getRuntime().freeMemory(); 
long 10 = Runtime.getRuntime().totalMemory(); 
MemoryUsageDemo.this.addTotalObservation((double) 1 0 ; 
MemoryUsageDemo.this.addFreeObservation((double) 1); 
j 
j 
public MemoryUsageDemo(int i) { 
super(new BorderLayout()); 
total - new TimeSeries( 
"Total Memory", 
(class$org$jfree$data$time$Millisecond == null ? (clas: 
class$org$jfree$data$time$Millisecond)); 
total.setMaximumItemAge((long) i); 
free - new TimeSeries( 
"Free Memory", 
(class$org$jfree$data$time$Millisecond -- null ? (clas: 
class$org$jfree$data$time$Millisecond)); 
free.setMaximumItemAge((long) i); 
TimeSeriesCollection timeseriescollection = new TimeSeries( 
timeseriescollection.addSeries(total); 
timeseriescollection.addSeries(free); 
DateAxis dateaxis - new DateAxis("Time"); 
NumberAxis numberaxis - new NumberAxis("Memory"); 
dateaxis.setTickLabelFont(new Font("SansSerif", 0, 12)); 
numberaxis.setTickLabelFont(new Font("SansSerif", 0, 12)); 
dateaxis.setLabelFont(new Font("SansSerif", 0, 14)); 
numberaxis.setLabelFont(new Font("SansSerif", 0, 14)); 
XYLineAndShapeRenderer xylineandshaperenderer - new XYLine/ 
true, false); 
xylineandshaperenderer.setSeriesPaint(0, Color.red); 
xylineandshaperenderer.setSeriesPaint(1, Color.green); 
xylineandshaperenderer.setSeriesStroke(0, new BasicStroke(: 
xylineandshaperenderer.setSeriesStroke(1, new BasicStroke(: 
XYPlot xyplot - new XYPlot(timeseriescollection, dateaxis, 
xylineandshaperenderer ); 
xyplot.setBackgroundPaint(Color.lightGray); 
xyplot.setDomainGridlinePaint(Color.white); 
xyplot.setRangeGridlinePaint(Color.white); 
xyplot.setAxisOffset(new RectangleInsets(5.0, 5.0, 5.0, 5.( 


} 


dateaxis.setAutoRange(true); 

dateaxis.setLowerMargin(0.0); 

dateaxis.setUpperMargin(0.0); 

dateaxis.setTickLabelsVisible(true); 

numberaxis.setStandardTickUnits(NumberAxis.createIntegerTic 

JFreeChart jfreechart = new JFreeChart("JVM Memory Usage", 
"SansSerif", 1, 24), xyplot, true); 

jfreechart.setBackgroundPaint(Color.white); 

ChartPanel chartpanel - new ChartPanel(jfreechart, true); 

chartpanel.setBorder(BorderFactory.createCompoundBorder (Bot 
.createEmptyBorder(4, 4, 4, 4), BorderFactory 
.createLineBorder(Color.black))); 

add(chartpanel); 


private void addTotalObservation(double d) { 


j 


total.add(new Millisecond(), d); 


private void addFreeObservation(double d) { 


j 


free.add(new Millisecond(), d); 


public static void main(String[] strings) { 


j 


JFrame jframe - new JFrame("Memory Usage Demo"); 
MemoryUsageDemo memoryusagedemo = new MemoryUsageDemo ( 3000( 
jframe.getContentPane().add(memoryusagedemo, "Center"); 
jframe.setBounds(200, 120, 600, 280); 
jframe.setVisible(true); 
memoryusagedemo.new DataGenerator(100).start(); 
jframe.addwindowListener(new WindowAdapter() { 

public void windowClosing(WindowEvent windowevent) { 

System.exit(0); 
} 


3): 


/* synthetic */static Class class$(String string) { 


Class var. class; 

try í 
var_class = Class.forName(string); 

} catch (ClassNotFoundException classnotfoundexception) { 
throw new NoClassDefFoundError(classnotfoundexception. ¢ 


} 


return var_class; 





11 图 表 工 具 条 (Tooltips) 


11.1 概述 


Saree ee 套 产生 、 收 集 和 显示 工具 条 的 机 制 。 本 章 主 
要 介 . 


如 何 产生 图 表 工 具 条 (包括 定制 图 表 工 具 条 ) 
如 何 收集 图 表 工 具 条 
如 何 显示 图 表 工 具 条 
如 何 隐 藏 图 表 工 具 条 


11.2 创建 图 表 工 具 条 
如 果 我 们 需要 使 用 图 表 工 具 条 ， 我 们 首先 确保 所 画 的 图 表 中 已 经 Enc 


我 们 可 以 为 我 们 的 图 区 或 图 区 条 目 设 置 图 表 工 具 条 产生 器 。 在 下 面 的 相关 章 
面 ， 我 们 将 了 解 如 何 为 一 个 图 表 设 置 一 个 图 表 工 具 条 。 


11.2.1 饼 
饼 图 类 PiePlot 使 用 PieToolTipGenerator 接 口 产生 接口 图 表 工 具 条 。 系 统 通过 了 该 接 


口 的 一 个 标准 实现 类 StandardPieToolTipGenerator。PiePlot 设 置 图 表 工 具 条 的 方法 
MP: 


public void setToolTipGenerator(PieToolTipGenerator generator); 


该 方法 可 以 为 饼 图 设置 工具 条 产生 器 ， 如 果 设 置 null, 则 表示 没有 工具 条 。 


11.2.2 generated. 种 类 


种 类 图 表 一 包括 JFreeChart 创 建 最 多 的 直方 条 形 图 一 基于 CategoryPlot 类 并 使 用 
CategoryltemRenderer 来 画 每 一 个 数据 条 目 。Renderer 使 用 接口 
CategoryToolTipGenerator 的 指定 方法 来 获得 图 表 工 具 条 。 为 种 类 图 区 条 目 设置 图 
表 工 具 条 产生 器 ， 使 用 类 AbstractCategoryltemRenderer 的 方法 : 


public void setToolTipGenerator(CategoryToolTipGenerator generator: 
E — FEE 
该 方法 可 以 为 饼 图 设置 工具 条 产生 器 ， 如 果 设 置 null， 则 表示 没有 工具 条 。 





11.2.3 XY 图 
XY 图 表 一 包括 JFreeChart 创 建 的 散 点 图 和 时 序 图 一 基于 类 XYPlot 并 使 用 


XYltemRenderer 画 出 每 一 个 数据 条 目 。Renderer 使 用 一 个 XYToolTipGenerator 产 
生 图 表 工 具 条 。 


设置 XY 图 区 条 目的 工具 条 ， 使 用 在 AbstractXYltemRenderer 定 义 的 方法 : 


public void setToolTipGenerator(XYToolTipGenerator generator); 


如 果 设 置 产 生 器 为 null， 表 示 没 有 图 表 工 具 条 产生 器 。 


11.3 收集 图 表 工 具 条 


使 用 ChartRenderinglnfo 类 可 收集 图 表 工 具 条 信息 ， 以 及 图 表 的 其 他 信息 。 我 们 首 
先 要 向 JFreeChart 的 draw() 方 法 传人 该 类 实例 ， 否 则 图 表 工 具 条 信息 将 不 被 记录 
(即便 是 产生 器 已 经 被 注册 到 图 区 的 数据 条 目 中 ) 。 


幸运 的 是 ，ChartPanel 会 自动 的 处 理 图 表 工 具 条 的 收集 。 因 此 如 果 我 们 使 用 
ChartPanel 显 示 我 们 的 图 表 ， 就 不 用 担心 图 表 工 具 条 的 收集 一 因为 ChartPanel 已 经 
为 我 们 收集 了 。 


11.4 显示 图 表 工 具 条 


使 用 ChartPanel 类 创建 我 们 的 图 表 时 ， 图 表 工 具 条 会 自动 显示 出 来 。 并 且 你 可 以 为 
图 区 (或 者 图 区 的 renderer) 设置 一 个 图 表 工 具 条 。 


我 们 可 是 使 用 类 的 方法 设置 显示 或 隐藏 图 表 工 具 条 。 方 法 如 下 : 


public void setDisplayToolTips(boolean flag); 


11.5 im [e] zx T B AR 


最 有 效 的 方式 就 是 将 图 表 工 具 条 设置 为 null。 确 保 没 有 任何 图 表 工 具 条 信息 产生 ， 
这 样 可 以 节省 内 存 同 时 提供 处 理 速度 (特别 是 对 于 大 数据 源 时 ， 非 常 有 好 处 ) 。 


我 们 可 是 使 用 上 节 讲 的 方法 使 用 ChartPanele 类 设置 图 表 工 具 条 的 隐藏 。 


11.6 定制 图 表 工 具 条 
我 们 可 以 通过 相应 的 图 表 工 具 条 产生 器 接口 对 每 一 个 图 表 工 具 条 进行 文本 的 各 种 操 
作 。 


12 图 表 条 目标 签 (Item Label) 


12.1 简介 


12.1.1 概述 


对 于 大 多 数 的 图 表 类 型 来 说 ，JFreeChart 允 许 我 们 在 图 表 的 每 个 条 目 上 、 或 者 内 
部 、 或 者 附近 显示 条 目标 签 。 例 如 ， 下 图 12.1 在 每 个 条 形 图 上 显示 出 了 真实 的 值 。 


= Item Label Demo 


Item Label Demo 1 
93.0 





Category 





图 12.1 显示 数组 的 条 形 图 (64: ) 
本 章 主要 讲述 : 


e 如 何 让 条 目标 签 可 祝 ( 仅 限于 支持 条 目标 签 的 图 表 类 型 ) 
e 如 何 改变 条 目标 签 的 外 观 (字体 和 颜色 ) 

。 如 何 指定 条 目标 签 的 位 置 

e 如何 定制 条 目标 签 的 文本 


忠告 : 我 们 使 用 上 面 的 特征 时 ， 要 说 愤 。 图 表 是 期 望 用 来 分 析 总 结 数据 的 一 一 如 果 
我 们 觉得 在 图 表 上 显示 真实 数据 是 非常 有 必要 的 话 ， 那 我 们 的 数据 应 使 用 一 个 表格 
格式 显示 更 为 合适 。 


12.1.2 局 限 性 


在 当前 版 本 JFreeChart 中 ， 条 目标 签 的 使 用 是 有 很 多 局 限 性 的 : 
e 一 些 renderer 不 支持 条 目标 签 
e 轴 范 围 的 自动 调节 ， 忽 上 略 了 条 目标 签 的 自动 调整 一 一 如 果 图 表 的 周围 没有 足够 
的 空间 (使 用 方法 setUpperMargin() 或 setLowerMargin() 进 行 了 相应 的 调 
整 ) ， 那 么 一 些 图 表 条 目标 签 在 图 表 上 显示 不 出 来 。 


相信 ， 在 以 后 的 JFreeChart 版 本 中 ， 这 些 限 制 问题 将 被 解决 。 


12.2 显示 条 目标 签 


12.2.1 概述 
条 目标 签 默认 是 不 显示 的 ， 因 此 我 们 需要 使 用 renderer 进 行 创建 和 显示 条 目标 签 。 
这 主要 有 以 下 两 个 步骤 : 


e 分 配 一 个 CategoryltemLabelGenerator 或 XYltemLabelGenerator 给 renderer 一 
这 是 一 个 负责 创建 标签 的 对 象 。 
e 在 renderer 里 面 设置 一 个 标签 可 视 的 标志 。 可 以 针对 全 部 系列 进行 设置 ， 也 可 
以 针对 具体 的 每 一 个 系列 进行 设置 。 
此 外 ， 我 们 可 以 定制 条 目标 签 的 位 置 、 字 体 和 颜色 。 在 下 面 的 章节 里 我 们 将 详细 的 


介绍 。 


12.2.2 创建 一 个 条 目标 签 并 赋值 


a renderer 分 配 的 一 个 标签 产生 器 创建 条 目标 签 ( 这 和 与 图 表 工 具 条 的 机 制 是 相同 
的 ) 。 


下 面 代 码 说 了 将 一 个 标签 产生 器 指派 给 CategoryltemRenderer : 


CategoryItemRenderer renderer = categoryplot.getRenderer(); 
CategoryItemLabelGenerator generator = new StandardCategoryItemLabe 
renderer .setBaseItemLabelGenerator (generator); 


国定 
同样 的 ， 将 一 个 产生 器 指派 给 XYltemRenderer， 代 码 如 下 : 





XYPlot plot = (XYPlot) jfreechart.getPlot(); 

XYItemRenderer renderer = plot.getRenderer(); 

XYItemLabelGenerator generator = new StandardXYItemLabelGenerator( 
"(2)", new DecimalFormat("0.00"), new DecimalFormat("0.00")); 

renderer .setBaseItemLabelGenerator(generator); 
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们 总 计 的 产生 器 ， 详 见 12.5.2 章 节 。 

12.2.3 所 有 的 系列 显示 条 目标 签 


方法 renderer.setBaseltemLabelsVisible(false) 是 控制 着 条 目标 签 的 显示 。 对 于 
CategoryltemRenderer : 


CategoryItemRenderer renderer = categoryplot.getRenderer(); 
renderer.setBaseltemLabelsVisible(true); 


同样 对 于 : XYltemRenderer 


XYItemRenderer renderer = categoryplot.getRenderer(); 
renderer.setBaseltemLabelsVisible(true); 


—Hi 受 置 ， 这 个 标志 优先 管理 我 们 在 所 有 地 方 对 每 一 系列 做 的 设置 ， 主 要 为 了 应 用 
二 系列 的 设置 。 我 们 可 以 设置 个 标志 为 hull ( 见 12.2 4 章 节 ) 


12.2.4 为 选择 的 系列 显示 条 目标 签 


de 签 是 否 显 示 。 例 如 : 如 下 图 12.2 仅 显示 第 
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Category 
如 图 12.2 显 示 第 一 系列 条 目标 签 
下 面 代码 可 以 设置 如 上 效果 : 





CategoryItemRenderer renderer = categoryplot.getRenderer(); 
renderer .setBaseItemLabelGenerator(new StandardCategoryItemLabelGer 
renderer.setBaseItemLabelsVisible(null); // clears the ALL series 1 
renderer.setSeriesItemLabelsVisible(0, true); 
renderer.setSeriesItemLabelsVisible(1, false); 


注意 : 上 面 代 码 中 对 全 部 的 系列 设置 为 null 一 这 一 点 非常 重要 ， 因 为 全 部 系列 的 标 
志 控 制 每 一 个 系列 的 标志 。 





12.2.5 问题 与 解决 


如 果 按 照 上 面 的 步 又 操作 ， 你 仍然 未 看 见 条 目标 签 显示 在 图 表 上 ， 那 么 我 们 从 以 下 
几 个 方面 进行 考虑 : 


e Renderere 必 须 需要 一 个 标签 产生 器 一 一 这 是 一 个 用 来 创建 每 一 个 标签 的 文本 
条 目的 对 象 。 
e 一 些 renderer 不 支持 条 目标 签 (具体 参考 renderer 相 关 的 文档 ) 


12.3 条 目标 签 外 观 


12.3.1 概述 


我 们 可 以 通过 改变 条 目的 颜色 、 字 体 来 改变 图 表 条 目标 签 的 外 观 。 正 如 其 他 
renderer 属 性 一 样 ， 属 性 的 设置 可 以 是 全 部 的 系列 ， 可 以 是 具体 某 一 系列 。 


在 JFreeChart 目 前 的 版 本 中 ， 标 签 是 月 年 个 一 个 透明 的 背景 画 出 来 的 。 我 们 不 能 设 
置 标签 的 背景 颜色 ， 也 不 能 指定 标签 的 边框 。 这 些 在 以 后 的 版 本 中 会 得 到 解决 。 
12.3.2 改变 条 目标 签 的 字体 

为 了 在 所 有 的 系列 中 改变 条 目标 签 的 字体 ， 我 们 可 以 使 用 下 面 的 代码 : 


CategoryItemRenderer renderer = categoryplot.getRenderer(); 
renderer.setBaseItemLabelFont(new Font(" 黑 体 "，Font .PLAIN，20) ) ; 


同样 ， 也 可 以 为 单个 系列 设置 字体 : 


// add settings for individual series... 
renderer.setSeriesItemLabelFont(0, new Font("SansSerif", Font.PLAI! 
renderer.setSeriesItemLabelFont(1, new Font("SansSerif", Font.PLAI! 


EOE o 


注意 : renderer.setBaseltemLabelFont(null) 方 法 会 出 错 。 开 发 指南 显示 的 代码 有 错 
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12.3.3 改变 条 目标 签 的 颜色 
改变 条 目标 签 的 颜色 ， 我 们 可 以 使 用 下 面 的 代码 : 


CategoryItemRenderer renderer = categoryplot.getRenderer(); 
renderer.setBaseltemLabelPaint(Color.red); 


同样 的 ， 可 以 为 单独 每 一 系列 设置 颜色 : 


// add settings for individual series... 
renderer.setSeriesItemLabelPaint(0O, Color.red); 
renderer.setSeriesItemLabelPaint(1, Color.blue); 


意 : renderer.setBaseltemLabelPaint(null); 方 法 会 出 错 。 开 发 指南 显示 的 代码 有 


12.4 条 目标 签 位 置 


12.4.1 概述 


条 目标 签 的 位 置 过 ltemLabelPosition 对 象 的 四 个 属性 来 控制 的 。 
我 们 可 以 通过 接口 CategoryltemRenderer 的 方法 来 独立 定义 条 目标 签 的 正 负 点 位 
iB: 


public void setBasePositiveltemLabelPosition(ItemLabelPosition pos: 
public void setBaseNegativeltemLabelPosition(ItemLabelPosition pos: 


4 MES 
理解 这 些 属 性 如 何 影响 独立 标签 的 最 终 位 置 的 关键 是 了 解 JFreeChart 里 面条 目标 签 
的 特征 。 四 个 特征 是 : 


e 条 目标 签 点 一 一 决定 标签 的 起 始 位 置 

° 文本 点 一 一 标签 里 的 文本 相对 于 条 目标 签 的 位 置 。 
e. 旋转 点 一 一 标签 文本 旋转 的 点 位 置 

e 旋转 角度 一 一 标签 的 旋转 角度 。 


这 些 的 详细 描述 在 下 一 章 详 细 介 绍 。 








12.4.2 条 目标 签 的 位 置 
设置 条 目标 签 位 置 的 目的 ， 主 要 是 为 了 找 出 标签 在 图 表 上 贴 向 数据 条 目的 一 个 点 


y) 位 置 。 同 时 在 画图 表 时 ， 该 标签 也 被 男 在 该 点 处 。 更 多 的 信息 可 以 参考 
ltemLabelAnchor 文 档 。 


12.4.3 标签 文本 的 位 置 


标签 文本 的 位 置 ， 主 要 取决 于 上 节 讲 的 标签 位 置 。 我 们 可 以 讲 标签 文本 在 标签 里 设 
置 在 右上 部 、 或 左下 部 等 ， 更 多 的 信息 参见 TextAnchor 文 档 。 


运行 JCommon 包 内 的 org. demo.package 下 面 的 DrawStringDemo 应 用 ， 可 以 更 好 
的 理解 标签 文本 在 标签 内 是 如 何 放置 的 。 


12.4.4 标签 旋转 点 


在 标签 上 定义 了 一 个 旋转 点 ， 用 于 旋转 标签 。 在 DrawStringDemo 实 例 中 很 好 演示 
了 这 个 特征 。 


12.4.5 标签 旋转 角度 


旋转 角度 定义 了 标签 治 旋 转 点 旋转 的 角度 。 该 角度 为 弧度 。 


12.5 定制 条 目标 签 文本 


12.5.1 概述 


定制 条 目标 签 文本 ， 我 们 需要 依赖 用 JFreeChart 里 的 标签 产生 器 来 为 条 目标 签 创建 
文本 。 如 果 要 想 完 全 控制 标签 文本 的 控制 ， 我 们 就 需要 编写 自己 的 标签 产生 器 ， 需 
要 实现 接口 CategoryltemLabelGenerator。 


在 本 章节 里 ， 我 们 对 自 定义 标签 器 技术 做 了 简要 的 讲述 ， 然 后 用 两 个 实例 来 说 明 该 
技术 过 程 。 
12.5.2 实现 一 个 目 定义 的 标签 产生 器 
开发 一 个 自 定义 标签 产生 器 ， 我 们 需要 写 一 个 类 ， 该 类 必须 实现 
CategoryltemLabelGenerator 接 口 里 的 方法 。 

public String generateLabel(CategoryDataset dataset, int series, int 
该 renderer 调 用 该 方法 获得 一 个 标签 的 字符 串 ， 并 且 将 该 字符 串 传 人 到 当前 条 目的 


CategoryDataset、 序 列 和 种 类 。 这 就 意味 着 创建 这 个 标签 时 ， 我 们 拥有 完全 的 访 
问 权 限 。 


该 方法 可 以 返回 任意 字符 串 ， 因 此 我 们 格式 化 这 个 字符 串 。 如 果 我 们 不 想 显示 标 
签 ， 可 以 设置 为 null。 


在 下 面 的 两 个 例子 中 很 好 的 说 明了 这 个 特征 。 





12.6 实例 1 


12.6.1 概述 


在 第 一 个 实例 中 ， 目 的 就 是 当当 条 目的 值 大 于 某 个 限定 的 值 时 ， 就 显示 该 标签 。 如 
图 12.3 所 示 。 
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如 图 12.3 超过 某 个 限定 值 显示 条 目标 签 的 实例 
做 到 这 一 点 并 不 困难 ， 需 要 做 以 下 工作 : 


e 写 一 个 实现 接口 CategoryltemLabelGenerator 的 类 ， 并 且 实 现 
generateltemLabel() 方 法 。 该 方法 实现 如 果 条 目的 值 小 于 限定 值 时 ， 返 回 
null, 

e 创建 该 类 的 实例 ， 将 该 实例 使 用 renderer 的 方法 setLabelGenerator() 设 置 到 
renderer 中 去 。 


12.6.2 源 代码 


package demo; 

import java.awt.Color; 

import java.awt.Dimension; 

import java.awt.Font; 

import java.text.DecimalFormat; 

import java.text.NumberFormat; 

import javax.swing.JPanel; 

import org.jfree.chart.ChartFactory; 
import org.jfree.chart.ChartPanel; 
import org.jfree.chart.JFreeChart; 
import org.jfree.chart.axis.NumberAxis; 
import org.jfree.chart.labels.AbstractCategoryItemLabelGenerator; 


import org. 
import org. 
import org. 
import org. 
import org. 
import org. 
import org. 
import org. 
import org. 
import org. 
import org. 
import org. 
import org. 


jfree.chart.labels.CategoryItemLabelGenerator; 
jfree.chart.labels.StandardCategoryItemLabelGenerator; 
jfree.chart.labels.StandardXYItemLabelGenerator; 
jfree.chart.labels.XYItemLabelGenerator; 
jfree.chart.plot.CategoryPlot; 
jfree.chart.plot.PlotOrientation; 
jfree.chart.plot.XYPlot; 
jfree.chart.renderer.category.CategoryItemRenderer; 
jfree.chart.renderer.xy.XYItemRenderer; 
jfree.data.category.CategoryDataset; 
jfree.data.category.DefaultCategoryDataset; 
jfree.ui.ApplicationFrame; 
jfree.ui.RefineryUtilities; 


public class ItemLabelDemo1 extends ApplicationFrame { 


static 


class LabelGenerator extends AbstractCategoryItemLabelG: 


implements CategoryItemLabelGenerator í 
private double threshold; 
public LabelGenerator(double d) { 


j 


super("", NumberFormat.getInstance()); 
threshold - d; 


public String generateLabel(CategoryDataset categorydatasel 


ine “ate (0 A 
String string = null; 
Number number = categorydataset.getValue(i, i O ); 
if (number != null) { 
double d - number.doubleValue(); 
if (d &gt; threshold) 
string - number.toString(); 


} 


return string; 


ItemLabelDemoi(String string) { 


super(string); 

CategoryDataset categorydataset = createDataset(); 
JFreeChart jfreechart = createChart(categorydataset ); 
ChartPanel chartpanel = new ChartPanel(jfreechart); 
chartpanel.setPreferredSize(new Dimension(500, 270)); 
setContentPane(chartpanel); 


j 
j 
public 
j 


private static CategoryDataset createDataset() { 
DefaultCategoryDataset defaultcategorydataset = new Default 
defaultcategorydataset.addValue(11.0, "S1", "C1"); 


defaultcategorydataset.addValue(44. 


defaultcategorydataset.addValue(35. 


WSIS EPL Ne 
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3, 
defaultcategorydataset.addValue(93.0, "S1", "C3"); 

6, 

1, 


defaultcategorydataset.addValue(75. 
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return defaultcategorydataset; 


} 


private static JFreeChart createChart(CategoryDataset category 
JFreeChart jfreechart = ChartFactory.createBarChart ( 


"Item Label Demo 1", "Category", "Value", categorydata: 


} 


PlotOrientation.VERTICAL, false, true, false); 
jfreechart.setBackgroundPaint(Color.white); 

CategoryPlot categoryplot = (CategoryPlot) jfreechart.getP- 
categoryplot.setBackgroundPaint(Color.lightGray); 
categoryplot.setDomainGridlinePaint(Color.white); 
categoryplot.setRangeGridlinePaint(Color.white); 

NumberAxis numberaxis - (NumberAxis) categoryplot.getRange/ 
numberaxis.setUpperMargin(0.15); 

return jfreechart; 


public static JPanel createDemoPanel() ( 


} 


public static void main(String[] strings) { 

ItemLabelDemo1 itemlabeldemo1 = new ItemLabelDemoi("Item Lé 
itemlabeldemo1.pack(); 
RefineryUtilities.centerFrameOnScreen(itemlabeldemo1l); 
itemlabeldemo1.setVisible(true); 


JFreeChart jfreechart = createChart(createDataset()); 
return new ChartPanel(jfreechart); 





12.7 实例 2 


12.7.1 概述 


在 本 实例 中 ， 目 的 是 在 每 个 系列 的 标签 上 显示 出 值 和 百分比 值 (这 个 百分比 值 ， 这 
个 系列 在 某 一 部 分 的 条 形 直 方 图 或 全 部 条 形 直 方 图 的 总 值 中 的 比值 ) 。 如 下 图 12.4 
所 示 。 
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图 12.4 带 有 比值 的 直方 图 


该 实现 中 ， 标 签 产生 器 计算 出 百分比 。 如 果 传 人 构造 函数 的 是 一 个 种 类 索引 ， 那 么 
这 个 百分比 的 基数 就 是 指定 种 类 的 当前 系列 的 值 。 如 果 种 类 索引 是 无 效 的 ， 那 么 这 
个 基数 就 是 指定 种 类 的 全 部 系列 总 和 。 


标签 产生 器 会 默认 创建 一 个 百分比 格式 一 一 一 种 比较 成 熟 的 格式 ， 提 供 格式 化 能 
力 。 


12.7.2 RAG 


package demo; 

import java.awt.Color; 

import java.awt.Dimension; 

import java.text.NumberFormat; 

import javax.swing.JPanel; 

import org.jfree.chart.ChartFactory; 

import org.jfree.chart.ChartPanel; 

import org.jfree.chart.JFreeChart; 

import org.jfree.chart.axis.AxisLocation; 

import org.jfree.chart.axis.NumberAxis; 

import org.jfree.chart.labels.AbstractCategoryItemLabelGenerator; 
import org.jfree.chart.labels.CategoryItemLabelGenerator; 


import 
import 
import 
import 
import 
import 
import 
public 


org.jfree.chart.plot.CategoryPlot; 
org.jfree.chart.plot.PlotOrientation; 
org.jfree.chart.renderer.category.CategoryItemRenderer; 
org.jfree.data.category.CategoryDataset; 
org.jfree.data.category.DefaultCategoryDataset; 
org.jfree.ui.ApplicationFrame; 
org.jfree.ui.RefineryUtilities; 

class ItemLabelDemo2 extends ApplicationFrame { 


static class LabelGenerator extends AbstractCategoryItemLabelG: 
implements CategoryItemLabelGenerator í 


} 


private Integer category; 
private NumberFormat formatter = NumberFormat.getPercentIn: 
public LabelGenerator(int i) { 

this(new Integer(i)); 


public LabelGenerator(Integer integer) { 
super("", NumberFormat.getInstance()); 
category - integer; 


public String generateLabel(CategoryDataset categorydatasel 
imne aeos) t 
String string = null; 
double d = 0.0; 
if (category != null) { 
Number number = categorydataset 
.getValue(i, category.intValue()); 
d = number .doubleValue(); 
} else 
d = calculateSeriesTotal(categorydataset, i 
Number number = categorydataset.getValue(i, i_© 
if (number != null) { 
double d 1 = number .doubleValue(); 
string = (number.toString() + " (" + formatter.forr 


): 
Es 


j 


return string; 
j 
private double calculateSeriesTotal(CategoryDataset catego! 
int i) í 
double d = 0.0 
for (int 12 = 0; i 2 &lt; categorydataset.getColumnCounl 
Number number = categorydataset.getValue(i, i 2 ); 


Il >~- 


if (number != null) 

d += number.doubleValue(); 
} 

return d; 

} 


public ItemLabelDemo2(String string) { 


super(string); 

CategoryDataset categorydataset = createDataset(); 
JFreeChart jfreechart = createChart(categorydataset ); 
ChartPanel chartpanel = new ChartPanel(jfreechart); 
chartpanel.setPreferredSize(new Dimension(500, 270)); 


} 


setContentPane(chartpanel); 


private static CategoryDataset createDataset() ( 


j 


DefaultCategoryDataset defaultcategorydataset = new Default! 
defaultcategorydataset.addValue(100.0, "Si", "C1"); 
defaultcategorydataset.addValue(44.3, "S1", "C2"); 
defaultcategorydataset.addValue(93.0, "S1", "C3"); 
defaultcategorydataset.addValue(80.0, "S2", "C1"); 
defaultcategorydataset.addValue(75.1, "S2", "C2"); 
defaultcategorydataset.addValue(15.1, "S2", "C3"); 

return defaultcategorydataset; 


private static JFreeChart createChart(CategoryDataset category: 


j 


JFreeChart jfreechart = ChartFactory.createBarChart ( 

"Item Label Demo 2", "Category", "Value", categorydata: 
PlotOrientation.HORIZONTAL, true, true, false); 
jfreechart.setBackgroundPaint(Color.white); 

CategoryPlot categoryplot = (CategoryPlot) jfreechart.getP- 
categoryplot.setBackgroundPaint(Color.lightGray); 
categoryplot.setDomainGridlinePaint(Color.white); 
categoryplot.setRangeGridlinePaint(Color.white); 
categoryplot.setRangeAxisLocation(AxisLocation.BOTTOM OR LE 
NumberAxis numberaxis - (NumberAxis) categoryplot.getRange/ 
numberaxis.setUpperMargin(0.25); 

CategoryItemRenderer categoryitemrenderer = categoryplot .ge 
categoryitemrenderer.setBaseltemLabelsVisible(true); 
categoryitemrenderer.setBaseltemLabelGenerator(new LabelGer 

(Integer) null)); 
return jfreechart; 


public static JPanel createDemoPanel() { 


JFreeChart jfreechart - createChart(createDataset()); 
return new ChartPanel(jfreechart); 


public static void main(String[] strings) { 

ItemLabelDemo2 itemlabeldemo2 = new ItemLabelDemo2("Item Lé 
itemlabeldemo2.pack(); 
RefineryUtilities.centerFrameOnScreen(itemlabeldemo2); 
itemlabeldemo2.setVisible(true); 





13 多 轴 和 数据 源 图 表 (Multi Axis and Dataset) 


13.1 简介 


J FreeChart 在 CategoryPlot 和 XYPlot 类 中 支持 多 轴 和 数据 源 显 示 。 我 们 利用 这 个 特 
征 可 以 在 一 个 图 表 上 显示 两 个 或 多 个 数据 源 数据 ， 但 对 于 数据 包含 的 数据 有 巨大 差 
距 时 留 有 一 定 的 余地 。 如 图 13.1 所 示 。 
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413.1 具有 多 轴 的 图 表 


典型 的 ， 使 用 JFreeChart 构 建 图 表 时 ， 图 表 有 一 个 单数 据 源 、 单 renderer、 单 X/Y 轴 
的 图 区 最 为 常见 。 然 而 ， 在 一 个 图 区 上 添加 多 个 数据 源 、 多 个 renderer 和 多 个 轴 也 
是 可 能 的 。 在 本 章 的 实例 中 ， 展 示 了 如 何在 一 个 图 区 上 显示 其 他 额外 的 数据 源 、 
renderer# 44. 





13.2 实例 


13.2.1 简介 


MultipleAxisDemo1.java 例 子 提供 了 一 个 很 好 的 实例 演示 如 何在 一 个 图 表 上 创建 多 
轴 的 应 用 。 本 章 在 每 一 步 的 代码 中 提供 了 很 多 建议 ， 详 见 后 面 的 章节 。 


13.2.2 创建 一 个 图 表 


创建 一 个 具有 多 轴 、 多 数据 源 、 多 renderer 的 图 表 ， 我 们 首先 要 创建 一 个 常规 的 图 
表 (例如 使 用 ChartFactory 类 创建 ) 。 在 本 实例 中 ， 创 建 了 一 个 时 序 图 ， 代 码 如 
下 : 


XYDataset dataset1 = createDataset("Series 1", 100.0, new Minute(), 
JFreeChart chart = ChartFactory.createTimeSeriesChart ( 

"Multiple Axis Demo 1", 

"Time of Day", 

"Primary Range Axis", 

dataset1, 

true, 

true, 

false 





13.2.3 添加 领 外 的 轴 
如 果 在 图 区 上 添加 额外 的 轴 ， 我 们 使 用 setRangeAxis() 方 法 来 添加 : 


NumberAxis numberaxis = new NumberAxis("Range Axis 2"); xyplot.setk 
xyplot.setRangeAxisLocation(1, AxisLocation.BOTTOM_OR_LEFT); 


ad C = 
方法 setRangeAxis() 是 用 来 添加 图 区 的 轴 ， 注 意 轴 的 索引 1 已 经 被 使 用 





我 们 添加 
其 他 轴 时 ， 通 过 增加 该 索引 来 添加 新 轴 。 方 法 setRangeAxisLocation() 人 允许 我 们 指 
定 轴 出 现 的 位 置 (使 用 AxisLocation 类 ) 。 我 们 添加 的 轴 可 以 跟 主 坐标 轴 同 一 勾 ， 
或 者 在 对 立 边 。 例 如 : 如 果 指 定 的 是 AxisLocation.BOTTOM_OR _LEFT， 这 意味 着 
如 果 图 区 的 方向 是 垂直 的 话 ， 将 在 右边 添加 了 一 个 Y 轴 ， 如 果 图 区 的 方向 是 水 平 的 
话 ， 将 在 底部 添加 一 个 Y 轴 。 





在 这 里 ， 图 表 上 每 一 添加 多 余 的 数据 源 ， 因 此 如 果 我 们 显示 该 图 表 ， 我 们 将 看 到 图 
上 显示 多 轴 ， 但 轴 上 无 数据 显示 。 


13.2.4 添加 一 个 额外 的 数据 源 
在 图 区 上 添加 一 个 额外 的 数据 源 ， 使 用 setDataset() 方 法 


XYDataset xydataset © = createDataset("Series 2", 1000.0, 
new Minute(), 170); 
xyplot.setDataset(1, xydataset_0_); 


缺 省 的 ， 数 据 源 将 使 用 主轴 来 显示 数据 。 如 果 使 数据 源 在 另外 的 轴 上 显示 数据 ， 需 
使 用 方法 mapDatasetToDomainAxis() 和 mapDatasetToRangeAxis()。 这 两 个 方法 接 
受 两 个 参数 ， 第 一 个 参数 是 数据 源 的 索引 ， 第 二 个 是 轴 的 索引 。 


13.2.5 添加 一 个 额外 的 renderer 


当 我 们 添加 一 个 数据 源 时 ， 通 常 为 该 数据 源 添 加 一 个 附加 的 renderer 也 是 非常 有 意 
义 的 。 使 用 方法 setRenderer() : 


StandardXYItemRenderer standardxyitemrenderer = new StandardXYItemt 
xyplot.setRenderer(1, standardxyitemrenderer); 


kp uwa 


方法 的 第 一 个 参数 为 上 节 中 添加 的 数据 源 的 索引 。 注意 : 如 果 我 们 不 想 为 数据 源 指 
定 一 个 附加 的 rendere， 系统 将 默认 使 用 主 renderer， 这 样 系列 的 颜色 就 会 在 主 数据 
源 和 附加 数据 源 之 间 共 共享 。 





13.3 建议 和 技巧 


当 我 们 使 用 多 轴 图 表 时 ， 我 们 需要 为 系列 对 应 的 轴 提 供 一 些 可 视 化 的 建议 。 比 如 在 
例子 MultipleAxisDemo1.java 中 轴 标 签 的 颜色 与 系列 颜色 是 相 匹配 的 。 


可 以 从 下 面 的 实例 中 学 习 更 多 的 技巧 : 


DualAxisDemo1.java 
DualAxisDemo2.java 
DualAxisDemo3.java 
DualAxisDemo4.java 
MultipleAxisDemo1.java 
MultipleAxisDemo2.java 
MultipleAxisDemo3.java 


14 AS HR (Combined Charts) 


14.1 简介 
JFreeChart 支 持 几 个 图 区 类 (可 以 管理 着 多 个 子 类 ) 组 合 而 成 的 图 表 。 图 区 类 可 以 
管理 几 个 子 类 : 


e CombinedDomainCategoryPlot / CombinedRangeCategoryPlot 
e CombinedDomainxYPlot / CombinedRangeXYPlot ; 


本 章 使 用 几 个 实例 说 明了 JFreeChart 创 建 组 合 图 表 时 的 便利 性 。 


14.2 组 合 X 种 类 图 区 


14.2.1 概述 


组 合 主 域 种 类 图 区 就 是 在 一 个 图 区 上 显示 两 个 或 者 多 个 子 图 区 (CategoryPlot 实 
fl) ， 共 享 一 个 X 轴 的 图 区 。 每 个 子 图 区 维护 自己 的 Y 轴 。 实 例如 图 14.1 所 示 。 
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14.2.2 构建 图 表 


提供 了 一 个 很 好 的 例子 ， 演 示 如 何 创建 该 图 表 的 类 型 。 关 键 的 步 又 是 创建 
CombinedDomainCategoryPlot 实 例 ， 然 后 添加 两 个 子 图 区 : 


CategoryAxis domainAxis = new CategoryAxis("Category"); 
CombinedDomainCategoryPlot plot = new CombinedDomainCategoryPlot (dt 
plot.add(subploti, 2); 
plot.add(subplot2, 1); 
JFreeChart result = new JFreeChart( 

"Combined Domain Category Plot Demo", 

new Font("SansSerif", Font.BOLD, 12), 

plot, 

true 


); 


注意 ， 我 们 subplot1 添 加 码 值 时 是 2 (方法 add() 的 第 二 个 参数 ) ， 而 subplot1 添 加 
的 是 1 呢 ? 因为 这 控制 着 分 配给 各 个 图 区 的 空间 大 小 。 








子 图 区 的 CategoryPlot 实 例 对 象 将 它们 的 X 轴 设置 为 null。 例 如 在 演示 的 实例 中 ， 代 
码 如 下 : 


CategoryDataset dataseti = createDataset1(); 

NumberAxis rangeAxisi = new NumberAxis("Value"); 
rangeAxisi.setStandardTickUnits(NumberAxis.createlntegerTickUnits(: 
LineAndShapeRenderer rendereri = new LineAndShapeRenderer(); 
renderer1.setBaseToolTipGenerator(new StandardCategoryToolTipGener: 
CategoryPlot subploti = new CategoryPlot(dataseti, null, rangeAxis: 
subploti.setDomainGridlinesVisible(true); 

CategoryDataset dataset2 - createDataset2(); 

NumberAxis rangeAxis2 - new NumberAxis("Value"); 
rangeAxis2.setStandardTickUnits(NumberAxis.createlntegerTickUnits(: 
BarRenderer renderer2 - new BarRenderer(); 
renderer2.setBaseToolTipGenerator(new StandardCategoryToolTipGener: 
CategoryPlot subplot2 - new CategoryPlot(dataset2, null, rangeAxis: 
subplot2.setDomainGridlinesVisible(true); 
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14.3 组 合 Y 种 类 图 区 


14.3.1 概述 


一 个 组 合 Y 种 类 图 区 就 是 一 个 图 区 显示 两 个 或 两 个 以 上 的 子 图 区 (CategoryPlot 实 
例 ) ， 共 享 Y 轴 。 如 果 14.2. 


' JFreeChart: Combined Category Plot Demo 2 TBR) 
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Class 1 Class 2 
E] 14.2 组 合 Y 种 类 图 区 
该 图 表 可 以 水 平 显 示 也 可 以 垂直 显示 (本 例 是 垂直 显示 ) 。 





14.3.2 构建 图 表 


实例 演示 了 如 何 创建 该 类 型 图 表 。 关 键 的 步骤 是 创建 一 个 实例 ， 然 后 添加 两 个 子 图 
[X : 


ValueAxis rangeAxis = new NumberAxis("Value"); 


CombinedRangeCategoryPlot plot = new 
CombinedRangeCategoryPlot(rangeAxis); plot.add(subplot1, 3); 
plot.add(subplot2, 2); JFreeChart result - new JFreeChart("Combined Range 
Category Plot Demo", new Font("SansSerif", Font.BOLD, 12), plot, true); 


注意 添加 的 子 图 区 subp1Lot1 什 么 码 值 是 3 而 子 图 区 subp1ot2 码 值 是 2 呢 。 这 是 因为 该 值 控 
子 图 区 是 CategoryPlot 实 例 ， 将 Y 轴 设置 为 nul11。 例 如 ， 在 本 实例 演示 的 代码 如 下 : 
sj -- 














CategoryDataset dataset1 = createDataset1(); CategoryAxis domainAxis1 = new 
CategoryAxis("Class 1"); 
domainAxis1.setCategoryLabelPositions(CategoryLabelPositions.UP 45); 
domainAxis1.setMaxCategoryLabelWidthRatio(5.0f); LineAndShapeRenderer 
renderer1 = new LineAndShapeRenderer(); 

renderer1.setBase ToolTipGenerator(new StandardCategory Tool TipGenerator()); 
CategoryPlot subplot1 = new CategoryPlot(dataset1, domainAxis1, null, 
renderer1); subplot1.setDomainGridlinesVisible(true); CategoryDataset dataset2 = 
createDataset2(); CategoryAxis domainAxis2 = new CategoryAxis("Class 2"); 
domainAxis2.setCategoryLabelPositions(CategoryLabelPositions.UP 45); 
domainAxis2.setMaxCategoryLabelWidthRatio(5.0f); BarRenderer renderer2 = 
new BarRenderer(); renderer2.setBase ToolTipGenerator(new 

StandardCategory ToolTipGenerator()); CategoryPlot subplot2 = new 
CategoryPlot(dataset2, domainAxis2, null, renderer2); 
subplot2.setDomainGridlinesVisible(true); ``` 


14.4 组 合 X-XY 图 区 


14.4.1 概述 


组 合 X-XY 图 区 就 是 一 个 图 区 显示 两 个 或 者 多 个 子 图 区 (XYPlots Bl) ， 共 享 一 个 X 
轴 。 每 一 个 子 图 区 维护 自己 的 Y 轴 。 如 下 图 14.3 所 示 . 
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图 14.3 组 合 X-XY 图 区 (人 参见 : CombinedXYPlotDemo5.java) 
图 区 可 能 水 平 显示 也 可 能 垂直 显示 (本 例子 中 垂直 显示 ) 。 


14.4.2 构建 图 表 


CombinedXYPIlotDemo5.java 实 例 演示 了 如 何 创建 该 类 型 的 图 表 。 关 键 的 步骤 是 创 
建 一 个 实例 CombinedDomainXYPlot， 并 在 该 实例 上 添加 两 个 子 图 区 : 


CombinedDomainXYPlot plot = new CombinedDomainXYPlot(new NumberAxi: 
plot.setGap(10.0); 
plot.add(subploti, 1); 
plot.add(subplot2, 1); 
plot.setOrientation(PlotOrientation.VERTICAL); 
return new JFreeChart( 

"CombinedDomainXYPlot Demo", 

JFreeChart.DEFAULT TITLE FONT, plot, true 





注意 两 个 图 区 的 码 值 为 什么 都 是 1 呢 ? 因为 该 数值 控制 着 每 个 图 区 分 配 的 空间 大 


小 。 


子 图 区 是 XYPlot 实 例 ， 将 自己 的 X 轴 设置 为 null。 人 例如， 下面 的 代码 演示 了 这 个 特 
征 : 


XYDataset datai = createDataset1(); 

XYItemRenderer renderer1 = new StandardXYItemRenderer(); 
NumberAxis rangeAxisi = new NumberAxis("Range 1"); 

XYPlot subploti = new XYPlot(datai1, null, rangeAxisi, renderer1); 
subploti.setRangeAxisLocation(AxisLocation.BOTTOM OR LEFT); 
XYTextAnnotation annotation - new XYTextAnnotation("Hello!", 50.0, 
annotation.setFont(new Font("SansSerif", Font.PLAIN, 9)); 
annotation.setRotationAngle(Math.PI / 4.0); 
subploti.addAnnotation(annotation); 

// create subplot 2... 

XYDataset data2 - createDataset2(); 

XYItemRenderer renderer2 = new StandardXYItemRenderer(); 
NumberAxis rangeAxis2 - new NumberAxis("Range 2"); 
rangeAxis2.setAutoRangeIncludesZero(false); 

XYPlot subplot2 - new XYPlot(data2, null, rangeAxis2, renderer2); 
subplot2.setRangeAxisLocation(AxisLocation.TOP OR LEFT); 
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14.5 组 合 Y-XY 图 区 


14.5.1 概述 


组 合 Y-XY 图 区 就 是 一 个 图 区 显示 两 个 或 者 多 个 子 图 区 (XYPlot 实 例 ) ， 共 享 一 个 Y 
轴 。 每 一 个 子 图 区 维护 自己 的 X 轴 。 如 下 图 14.4 所 示 . 
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图 14.4 组 合 Y-XY 图 区 (参见 : CombinedXYPlotDemo5.java) 
图 区 可 能 水 平 显 示 也 可 能 垂直 显示 〈 本 例子 中 垂直 显示 ) o 





14.5.2 构建 图 表 


CombinedXYPlotDemo2java 实 例 演示 了 如 何 创 建 该 类 型 的 图 表 。 关 键 的 步 又 是 创 
建 一 个 实例 CombinedRangeXYPlot， 并 在 该 实例 上 添加 两 个 子 图 区 : 


// create the plot... 
CombinedRangeXYPlot plot = new CombinedRangeXYPlot(new NumberAxis(' 
plot.add(xyplot, 1); 
plot.add(xyplot O , 1); 
return new JFreeChart( 
"Combined (Range) XY Plot", 
JFreeChart.DEFAULT TITLE FONT, plot, true 


); 
Kl — g 
注意 两 个 图 区 的 码 值 为 什么 都 是 1 呢 ? 因为 该 数值 控制 着 每 个 图 区 分 配 的 空间 大 
小 。 


子 图 区 是 XYPlot 实 例 ， 将 自己 的 X 轴 设置 为 null。 人 例如， 下面 的 代码 演示 了 这 个 特 
征 : 





IntervalXYDataset intervalxydataset = createDataset1(); 
XYBarRenderer xybarrenderer = new XYBarRenderer(0.2); 
xybarrenderer.setBaseToolTipGenerator(new StandardXYToolTipGenerat« 
"{O}: ((1), {2})", new SimpleDateFormat("d-MMM-yyyy"), 
new DecimalFormat("0,000.0"))); 
XYPlot xyplot - new XYPlot(intervalxydataset, new DateAxis("Date"), 
null, xybarrenderer); 
XYDataset xydataset - createDataset2(); 
StandardXYItemRenderer standardxyitemrenderer - new StandardXYItemt 
standardxyitemrenderer 
.setBaseToolTipGenerator(new StandardXYToolTipGenerator( 
"{O}: ((1), {2})", new SimpleDateFormat ("d-MMM-yyyy"), 
new DecimalFormat("0,000.0"))); 
XYPlot xyplot O = new XYPlot(xydataset, new DateAxis("Date"), nul. 
standardxyitemrenderer); 
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15 数据 源 和 JDBC(Dataset And JDBC) 


15.1 简介 


本 章节 ， 主 要 讲述 使 用 JDBC 从 数据 库 表 中 获得 数据 的 几 种 数据 源 方法 : 


e JDBCPieDataset 
e JDBCCategoryDataset 
e JDBCXY Dataset 


15.2 XFJDBC 


JDBC (Java Data Base Connectivity,java 数 据 库 连接 ) 是 一 种 用 于 执行 SQL 语句 
的 Java API， 可 以 为 多 种 关系 数据 库 提 供 统一 访问 ， 它 由 一 组 用 Java 语 言 编写 的 类 
和 接口 组 成 。JDBC 提 供 了 一 种 基准 ， 据 此 可 以 构建 更 高 级 的 工具 和 接口 ， 使 数据 
库 开 发 人 员 能 够 编写 数据 库 应 用 程序 。 


15.3 样本 数据 


我 们 再 看 一 下 实际 运行 中 的 JDBC 数 据 源 。 我 们 需要 在 一 个 测试 数据 库 中 创建 一 些 
样本 数据 。 
下 面 列 出 了 创建 饼 图 、 直 方 条 形 图 和 时 序 图 的 祥 本 数据 。 


创建 饼 图 可 以 使 用 下 面 数据 〈 在 表 中 称谓 饼 数 据 ) 


CATEGORY VALUE 
London 54.3 
New York 43.4 
Paris 17.9 


同样 ， 直 方 条 形 图 使 用 下 面 数据 创建 (在 表 中 称谓 种 类 数据 ) 


CATEGORY SERIES1 SERIES2 SERIES3 
London 54.3 32.1 53.4 
New York 43.4 54.3 15-2 
Paris 17.9 34.8 37.1 


最 后 ， 时 序 图 表 的 使 用 的 数据 如 下 (在 表 中 称谓 xy 数 据 ) 


X SERIES1 SERIES2 SERIES3 
1-Aug-2002 54.3 32.4 53.4 
2-Aug-2002 43.4 54.3 75.2 
3-Aug-2002 39.6 55.9 37.1 
4-Aug-2002 35.4 55.2 27.5 
5-Aug-2002 33.9 49.8 22i 
6-Aug-2002 35.2 48.4 rr 
7-Aug-2002 38.9 49.7 15.3 
8-Aug-2002 36.3 44.4 121 
9-Aug-2002 31.0 46.3 11.0 


我 们 可 以 创建 一 个 测 斌 数据库， 包含 上 面 的 表 。 这 里 我 们 创建 一 个 jfreechartdb 数 所 
库 。 


在 下 一 章节 里 ， 我 们 使 用 PostgreSQL 创 建 数据 。 如 果 使 用 的 是 不 同 的 数据 库 系 
统 ， 我 们 需要 对 这 个 过 程 做 一 些 修改 。 


15.4 PostgreSQL 


15.4.1 XT PostgreSQL 


PostgreSQL 是 一 个 非常 强大 的 面向 关系 的 数据 库 服务 系统 ， 是 一 个 开源 的 分 布 式 系 
统 。 我 们 可 以 从 下 面 链 接 获 得 更 多 的 信息 : 


http://www.postgresql.org 


注意 尽管 PostgreSQL 是 开源 的 ， 但 它 具 有 其 他 大 型 商业 关系 数据 库 系 统 的 大 部 分 
特征 。 这 里 鼓励 你 安装 ， 并 使 用 它 。 


15.4.2 创建 一 个 新 的 数据 库 
首先 ， 登 录 数 据 库 管理 系统 ， 创 建 一 个 名 为 jfreechartdb 的 数据 库 。 


CREATE DATABASE jfreechartdb; 


其 次 ， 创 建 一 个 jfreechart 用 户 : 


CREATE USER jfreechart WITH PASSWORD ‘password’; 


JDBC 可 以 使 用 这 个 用 户 名 和 密码 进行 数据 库 的 连接 。 
15.4.3 创建 饼 图 数据 
创建 饼 图 数据 库 表 : 


CREATE TABLE piedata1 ( 
category VARCHAR(32), 
value FLOAT 

); 


加 入 样本 数据 : 


INSERT INTO piedatai VALUES ('London', 54.3); 
INSERT INTO piedatai VALUES ('New York’, 43.4); 
INSERT INTO piedatai VALUES (’Paris’, 17.9); 


15.4.4 创建 种 类 图 表 数 据 


创建 种 类 图 数据 库 表 : 


CREATE TABLE categorydata1i ( 
category VARCHAR(32), 
seriesi FLOAT, 
series2 FLOAT, 
series3 FLOAT 


); 


加 入 样本 数据 : 


INSERT INTO categorydatai VALUES ('London', 54.3, 32.1, 53.4); 
INSERT INTO categorydatai VALUES ('New York’, 43.4, 54.3, 75.2); 
INSERT INTO categorydatai VALUES ('Paris', 17.9, 34.8, 37.1); 


15.4.5 创建 XY 图 表 数 据 
创建 种 类 图 数据 库 表 : 


CREATE TABLE xydatai ( 
date DATE, 
seriesi FLOAT, 
series2 FLOAT, 
series3 FLOAT 


DE; 


加 入 样本 数据 : 
INSERT INTO xydatai VALUES ('1-Aug-2002', 54.3, 32.1, 53.4); 
INSERT INTO xydatai VALUES ('2-Aug-2002', 43.4, 54.3, 75.2); 
INSERT INTO xydatai VALUES ('3-Aug-2002', 39.6, 55.9, 37.1); 
INSERT INTO xydatai VALUES ('4-Aug-2002', 35.4, 55.2, 27.5); 
INSERT INTO xydatai VALUES ('5-Aug-2002', 33.9, 49.8, 22.3); 
INSERT INTO xydatai VALUES ('6-Aug-2002', 35.2, 48.4, 17.7); 
INSERT INTO xydatai VALUES ('7-Aug-2002', 38.9, 49.7, 15.3); 
INSERT INTO xydatai VALUES ('8-Aug-2002', 36.3, 44.4, 12.1); 
INSERT INTO xydatai VALUES ('9-Aug-2002', 31.0, 46.3, 11.0); 


15.4.6 设置 权限 


最 后 一 步 是 给 样本 数据 授 一 读 的 权限 给 新 用 户 jfreechart : 


GRANT SELECT ON piedatai TO jfreechart; 
GRANT SELECT ON categorydatai TO jfreechart; 
GRANT SELECT ON xydata1 TO jfreechart; 


15.5 JDBC 38 z/ 


为 了 使 用 JDBC 访 问 样本 数据 ， 我 们 需要 获得 数据 库 的 JDBC 驱 动 。 对 于 
PostgreSQL， 可 以 从 下 面 的 连接 下 载 : 
http://jdbc.postgresql.org 


为 了 使 用 这 个 驱动 ， 确 保 这 个 驱动 jar 文 件 加 到 classpath 中 。 


15.6 应 用 演示 


15.6.1 JDBC 饼 图 演示 


JDBC 饼 图 演示 实例 将 使 用 饼 图 数据 表 的 数据 产生 饼 图 。 该 数据 是 由 我 们 配置 的 数 
据 库 中 获得 的 。 


读数 据 的 代码 在 方法 readData() 中 : 


private PieDataset readData() { 

JDBCPieDataset data = null; 

String url = "jdbc:postgresql://nomad/jfreechartdb"; 

Connection con; 

try { 
Class.forName("org.postgresql.Driver"); 

} catch (ClassNotFoundException e) í 
System.err.print("ClassNotFoundException: "); 
System.err.println(e.getMessage()); 


try { 
con = DriverManager.getConnection(url, "jfreechart", "passv 
data - new JDBCPieDataset(con); 

String sql = "SELECT * FROM PIEDATA1;"; 
data.executeQuery(sql); 
con.close(); 

) catch (SQLException e) ( 
System.err.print("SQLException: "); 
System.err.println(e.getMessage()); 

y catch (Exception e) { 
System.err.print("Exception: "); 
System.err.println(e.getMessage()); 


return data; 





在 代码 中 需要 注意 的 事项 : 


eurl 是 连接 数据 库 的 链接 字符 串 。 
e 返回 的 查询 数据 使 用 了 JDBCPieDataset 类 对 象 进行 了 封装 。 详 细 内 容 见 文 
F5, 


15.6.2 JDBC 种 类 图 演示 


JDBC 种 类 图 应 用 使 用 种 类 数据 产生 了 一 个 条 形 直方 图 。 代 码 类 似 于 JDBC 饼 图 代 
码 。 但 我 们 需要 使 用 JDBCCategoryDataset 类 类 封装 格式 化 数据 。 


15.6.3 JDBC XY 图 演示 


JDBC XY 图 应 用 使 用 XY 数 据 产 生 了 一 个 时 序 图 。 代 码 类 似 于 JDBC 饼 图 代码 。 但 我 
们 需要 使 用 JDBCXYDataset 类 类 封装 格式 化 数据 。 


16 导出 图 表 为 PDF 格式 


16.1 简介 


在 本 章节 中 ， 我 们 讲述 如 何 将 一 个 JFreeChart 生 成 图 表 转 换 成 PDF 格式 文件 。 主 要 
使 用 的 工具 是 IText。 随 着 讲述 ， 在 后 面 的 章节 中 用 一 个 简单 的 实例 说 明 创 建 PDF 文 
件 的 过 程 ， 该 PDF 文件 包含 了 一 个 简单 的 图 表 。 生 成 的 文件 ， 可 以 使 用 Acrobat 阅 
读 器 来 阅读 ， 也 可 以 使 用 支持 PDF 文 件 阅读 的 阅读 器 来 阅读 。 


16.2 什么 是 Acrobat PDF 


Acrobat PDF 是 一 款 非常 流行 的 电子 文档 阅读 器 。 可 实现 不 同 的 硬件 平台 和 软件 应 
用 程序 之 间 的 信息 共享 ,不 受 软件 版 本 的 不 同和 安装 的 字体 的 影响 。PDF 可 以 使 用 
Adobe 提供 的 一 个 免费 工具 Acrodbat Reader 来 创建 。Acrodbat Reader 在 终端 用 户 
各 种 平台 上 是 有 效 的 ， 包 括 GNU/Linux,Windows,Unix,Machintosh 等 。 


如 果 你 的 系统 上 没有 安装 Acrodbat Reader， 可 以 到 下 面 链 接 去 下 载 : 


http://www.adobe.com/products/acrobat/readstep.html 


16.3 IText 


iText 是 一 个 能 够 快速 产生 PDF 文件 的 java 类 库 。iText 的 主页 下 载 地 址 是 : 
http://www.lowagie.com/iText 


截止 写本 文 的 时 间 ， 最 新 的 版 本 是 2.0.6 


16.4 Graphics2D 


JFreeChart 使 用 iText 工 具 是 非常 容易 的 事情 ， 因 为 iText 提 供 了 Graphics2D 的 实现 。 
在 我 们 说 明 实 例 应 用 之 前 ， 我 们 先 回顾 一 下 Graphics2D 的 类 。 


Java.awt. Graphics2D 类 ， 标 准 java2D API 的 一 部 分 。 定 义 了 在 二 维 空间 中 大 量 画 
文本 和 图 形 的 方法 。Graphics2D 部 分 子 类 义理 全 部 的 转化 细节 ， 从 输出 〈 文 本 和 图 
形 ) 到 具体 设置 的 映射 转化 。 


JFreeChart 画 图 表 时 ， 仅 仅 使 用 Graphics2D 定 义 的 方法 。 这 就 意味 着 JFreeChart 可 
以 将 图 表 输 出 到 Graphics2D 子 类 支持 的 任何 设备 。 


JFreeChart 





图 16.2 JFreeCharti& E] 8575 3 


iText 工 具 融 入 了 PdfGraphics2D 的 一 个 类 ， 这 就 意味 着 iText 使 用 Graphics2D 类 定义 
的 方法 产生 PDF 内 容 。 并 且 正 如 你 在 后 面 的 章节 中 看 到 的 ， 在 PDF 格式 中 产生 图 表 
会 变 的 非常 的 容易 。 


16.5 开始 导出 
为 了 完成 和 演示 应 用 实例 ， 我 们 需要 下 面 的 jar 文 件 : 


文件 描述 
jfreechart-1.0.6.jar JFreeChartX Æ 
jcommon-1.0.9.jar Jcommon š Æ 
itext-2.0.6.jar Itext 3: Æ 


首先 JFreeChart 包 括 两 个 jar 文 件 ， 其 次 iText 需 要 一 个 jar 文 件 。 


16.6 实例 应 用 
首先 ， 需 要 创建 一 个 图 表 ， 我 们 创建 一 个 时 序 图 ， 代 码 如 下 : 


XYDataset dataset = createDataset(); 
JFreeChart chart = ChartFactory.createTimeSeriesChart ( 
"Legal & General Unit Trust Prices", 
"Date" , 
"Price Per Unit", 
dataset, 
true, 
true, 
false 


DE 


这 里 没有 任何 的 特殊 代码 
代 上 面 的 代码 。 


下 一 步 ， 我 们 将 在 一 个 PDF 文件 中 保存 一 个 图 表 的 副本 : 


事实 上 ， 我 们 可 以 使 用 创建 JFreeChart 的 其 他 对 象 替 





File fileName = new File(System.getProperty("user.home") + "/jfreec 
saveChartAsPDF(fileName, chart, 400, 300, new DefaultFontMapper()), 


下 面 有 一 些 需要 注意 的 问题 : 


首先 ，PDF 文 件 名 称 是 硬 编码 完成 的 ， 不 能 修改 。 主 要 是 在 演示 中 ， 减 少 代 码 量 。 
在 实际 应 用 中 ， 我 们 需要 提供 一 些 让 用 户 指定 文件 名 称 与 路 径 的 方式 ， 上 比如 弹出 一 
个 文件 选择 对 话 框 。 


其 次 ，saveChartAsPDF() 方 法 还 未 实现 。 为 了 创建 这 个 方法 ， 我 们 先 创建 另 一 个 更 
通用 的 writeChartAsPDF(). 方 法 。 该 方法 执行 saveChartAsPDF() 方 法 需要 的 全 部 工 
作 。 但 该 方法 的 输入 参数 是 一 个 文件 输出 流 而 不 是 一 个 文件 ， 代 码 如 下 : 





public static void writeChartAsPDF(OutputStream out, JFreeChart ché 
int width, int height, FontMapper mapper) throws IOException { 
Rectangle pagesize = new Rectangle(width, height); 
Document document = new Document(pagesize, 50, 50, 50, 50); 
try { 
PdfWriter writer = PdfWriter.getInstance(document, out); 
document.addAuthor("JFreeChart"); 
document.addSubject("Demonstration"); 
document.open(); 
PdfContentByte cb = writer.getDirectContent(); 
PdfTemplate tp = cb.createTemplate(width, height); 
Graphics2D g2 = tp.createGraphics(width, height, mapper); 
Rectangle2D r2D = new Rectangle2D.Double(0, 0, width, heigl 
chart.draw(g2, r2D); 
g2.dispose(); 
cb.addTemplate(tp, 0, 0); 
) catch (DocumentException de) { 
System.err.println(de.getMessage()); 
} 


document.close(); 





在 上 面 代 码 的 方法 里 面 ， 我 们 看 到 一 些 创建 和 代码 iText 文 档 的 代码 ， 从 文档 中 获得 
了 一 个 Graphics2D 实 例 ， 使 用 Graphics2D 对 象 画 出 这 个 图 表 ， 并 关闭 了 这 个 文 
F5, 


同时 我 们 也 注意 到 方法 的 一 个 参数 是 FontMapper 对 象 。iText 使 用 FontMapper 接 口 
将 java 字 体 对 象 映射 成 基本 的 字体 对 象 。DefaultFontMapper 类 预先 默认 映射 为 java 
本 地 化 字体 。 如 果 你 希望 用 这 些 字体 ， 使 用 DefaultFontMapper 构 建 缺 省 的 对 象 即 
可 ， 如 果 你 相 使 用 其 他 的 字体 ( 例 支持 一 个 特殊 的 字符 集 ) ， 那 么 我 们 需要 做 
一 些 额 外 的 工作 。 本 章 后 面料 有 介绍 。 


在 writeChartAsPDF() 方 法 的 实现 里 面 ， 我 们 创建 了 一 个 自 定义 页 面 尺 寸 大 小 (匹配 
字符 的 需要 尺寸 ) 的 PDF 文档 。 我 们 提前 设置 了 改变 了 字符 的 尺寸 、 位 置 并 且 在 
PDF 文档 中 画 出 多 个 字符 ， 以 适应 不 同 的 页 面 尺寸 。 


现在 我 们 将 使 用 saveChartAsPDF() 方 法 很 容易 的 实现 了 将 一 个 PDF 数据 发 送 到 一 个 
数据 流 上 。 建 化 了 创建 文件 输出 流 的 过 程 ， 并 且 将 该 对 象 传 给 了 writeChartAsPDF() 
方法 。 代 码 如 下 : 


public static void saveChartAsPDF(File file, JFreeChart chart, int 
int height, FontMapper mapper) throws IOException { 
OutputStream out = new BufferedOutputStream(new FileOutputStre: 
writeChartAsPDF(out, chart, width, height, mapper); 
out.close(); 








上 面 的 每 一 步 代 码 都 是 必须 的 。 上 面 的 代码 组 合成 全 部 的 代码 如 下 (整个 工程 的 代 
码 都 在 这 里 ， 以 便 我 们 可 以 看 到 所 有 的 声明 和 内 容 ) : 


package demo; 

import java.awt.Graphics2D; 

import java.awt.geom.Rectangle2D; 

import java.io.BufferedOutputStream; 

import java.io.File; 

import java.io.FileOutputStream; 

import java.io.IOException; 

import java.io.OutputStream; 

import java.text.SimpleDateFormat; 

import org.jfree.chart.ChartFactory; 

import org.jfree.chart.JFreeChart; 

import org.jfree.chart.axis.DateAxis; 

import org.jfree.chart.plot.XYPlot; 

import org.jfree.chart.renderer.xy.XYLineAndShapeRenderer; 

import org.jfree.data.time.Month; 

import org.jfree.data.time.TimeSeries; 

import org.jfree.data.time.TimeSeriesCollection; 

import org.jfree.data.xy.XYDataset; 

import com.lowagie.text.Document; 

import com.lowagie.text.DocumentException; 

import com.lowagie.text.Rectangle; 

import com.lowagie.text.pdf.DefaultFontMapper; 

import com.lowagie.text.pdf.FontMapper; 

import com.lowagie.text.pdf.PdfContentByte; 

import com.lowagie.text.pdf.PdfTemplate; 

import com.lowagie.text.pdf.PdfWriter; 

JESS 

* A simple demonstration showing how to write a chart to PDF format 

* JFreeChart and iText. 

* &lt;P&gt; 

* You can download iText from http://www.lowagie.com/iText. 

T 

public class PDFExportDemo1 { 
EXER 
* 


Saves a chart to a PDF file. 


Qparam file 

the file. 

Qparam chart 

the chart. 

Qparam width 

the chart width. 
Qparam height 
the chart height. 


~*~ FF o 0 OR FF F oo F 


vr 

public static void saveChartAsPDF(File file, JFreeChart chart, 
int height, FontMapper mapper) throws IOException ( 
OutputStream out - new BufferedOutputStream(new FileOutput: 
writeChartAsPDF(out, chart, width, height, mapper); 


out.close(); 


* 
* 
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577 
public 


Writes a chart to an output stream in PDF format. 


Qparam out 

the output stream. 
Qparam chart 

the chart. 

Qparam width 

the chart width. 
Qparam height 

the chart height. 


static void writeChartAsPDF(OutputStream out, JFreeChart 


int width, int height, FontMapper mapper) throws IOException { 
Rectangle pagesize = new Rectangle(width, height); 
Document document = new Document(pagesize, 50, 50, 50, 50), 
try { 


Pdfwriter writer = PdfWriter.getInstance(document, out: 
document .addAuthor ("JFreeChart"); 

document .addSubject("Demonstration"); 

document .open( ); 

PdfContentByte cb - writer.getDirectContent(); 
PdfTemplate tp - cb.createTemplate(width, height); 
Graphics2D g2 = tp.createGraphics(width, height, mapper 
Rectangle2D r2D = new Rectangle2D.Double(0, 0, width, | 
chart.draw(g2, r2D); 

g2.dispose(); 

cb.addTemplate(tp, 0, 0); 


) catch (DocumentException de) { 


j 


System.err.println(de.getMessage()); 


document.close(); 


} 
JES 


£ Creates a dataset, consisting of two series of monthly data. 


* 


* @return the dataset. 


Lt 
public 


static XYDataset createDataset() { 


TimeSeries si = new TimeSeries("L&G European Index Trust", 


S1. 


si 


si 


si 


add(new Month(2, 2001), 181.8); 


.add(new Month(3, 2001), 167.3); 
S1. 
S1. 
S1. 


add(new Month(4, 2001), 153.8); 
add(new Month(5, 2001), 167.6); 
add(new Month(6, 2001), 158.8); 


.add(new Month(7, 2001), 148.3); 
S1. 
S1. 
S1. 


add(new Month(8, 2001), 153.9); 
add(new Month(9, 2001), 142.7); 
add(new Month(10, 2001), 123.2); 


.add(new Month(11, 2001), 131.8); 


S1. 
.add(new Month(1, 2002), 142.9); 
S1. 
S1. 
S1. 
.add(new Month(5, 2002), 139.8); 
si. 
S1. 


si 


si 


add(new Month(12, 2001), 139.6); 


add(new Month(2, 2002), 138.7); 
add(new Month(3, 2002), 137.3); 
add(new Month(4, 2002), 143.9); 


add(new Month(6, 2002), 137.0); 
add(new Month(7, 2002), 132.8); 


TimeSeries s2 = new TimeSeries("L&G UK Index Trust", Month 


s2. 
SAR 
s2. 
.add(new Month(5, 2001), 124.1); 
S2. 
SÅ: 
s2. 
.add(new Month(9, 2001), 112.7); 
S2. 
S2. 
S2. 
.add(new Month(1, 2002), 111.7); 
S2. 
SÅR 
s2. 
.add(new Month(5, 2002), 111.6); 
.add(new Month(6, 2002), 108.8); 
SAR 


S2 


s2 


s2 


s2 
s2 


add(new Month(2, 2001), 129.6); 
add(new Month(3, 2001), 123.2); 
add(new Month(4, 2001), 117.2); 


add(new Month(6, 2001), 122.6); 
add(new Month(7, 2001), 119.2); 
add(new Month(8, 2001), 116.5); 


add(new Month(10, 2001), 101.5); 
add(new Month(11, 2001), 106.1); 
add(new Month(12, 2001), 110.3); 


add(new Month(2, 2002), 111.0); 


add(new Month(3, 2002), 109.6); 
add(new Month(4, 2002), 113.2); 


add(new Month(7, 2002), 101.6); 


TimeSeriesCollection dataset = new TimeSeriesCollection(); 
dataset.addSeries(s1); 

dataset.addSeries(s2); 

return dataset; 


j 
public 


static void main(String[] args) { 


try í 


// create a chart... 

XYDataset dataset - createDataset(); 

JFreeChart chart - ChartFactory.createTimeSeriesChart( 
"Legal & General Unit Trust Prices", "Date", 
"Price Per Unit", dataset, true, true, false); 

// some additional chart customisation here... 

XYPlot plot - chart.getXYPlot(); 

XYLineAndShapeRenderer renderer = (XYLineAndShapeRende! 
.getRenderer(); 

renderer.setShapesVisible(true); 

DateAxis axis - (DateAxis) plot.getDomainAxis(); 

axis.setDateFormatOverride(new SimpleDateFormat ("MMM-y\ 

// write the chart to a PDF file... 

File fileName = new File(System.getProperty("user.home' 
+ "/jfreechart1.pdf"); 

System.out.println(fileName.getPath()); 

saveChartAsPDF(fileName, chart, 400, 300, new DefaultF: 


) catch (IOException e) ( 


System.out.println(e.getMessage()); 








在 你 完成 和 运行 上 面 的 应 用 之 前 ， 记 得 修改 PDF 文件 的 名 称 以 满足 我 们 的 要 求 。 同 
时 前 面 16.5 节 提 到 的 jar 也 必须 在 我 们 的 classpath 中 。. 


16.7 查看 PDF 文件 


在 我 们 完成 上 面 实例 ， 运 行 实例 ， 会 产生 一 个 PDF 文档 。 我 们 可 以 使 用 一 个 PDF 浏 
览 器 (比如 AcrobatReader (或 者 其 他 支持 的 阅读 器 ，Gnome PDF Viewer) ) & 
看 该 文件 ， 显 示 的 界面 如 下 图 16.3 
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图 16.3 JFreeChart 使 用 iText 生 成 的 PDF 文件 图 
大 部 分 的 PDF 阅读 器 都 提供 了 缩放 技术 ， 以 允许 我 们 更 进一步 浏览 我 们 的 图 表 。 


Price Per Unit 











16.8 Unicode £47 js] zi 
声明 : 由 于 本 人 对 自 字符 集 了 解 不 深 ， 因 此 翻译 效果 比较 差 ， 忘 各 大 网 友 给 予 大 力 
支持 。 


在 我 们 关心 我 们 所 使 用 的 字体 字符 集 时 ， 在 JFreeChart 和 iText 中 使 用 Unicode 字 符 
集 是 没有 任何 问题 的 。 在 上 面 的 例子 中 我 们 需要 做 一 些 修改 来 演示 如 何 做 到 这 些 


16.8.1 背景 


Java 使 用 同一 的 字符 集 译 码 成 文本 字符 串 。 这 种 译 码 对 每 个 字符 使 用 16 进 制 。 这 就 
意味 着 将 有 65，536 个 有 效 的 不 同 字 符 集 (在 Unicode 标 准 中 定义 了 大 约 38，000 个 
字符 ) 。 


我 们 可 以 在 JFreeChart 和 iText 中 使 用 这 些 字符 ,但 为 于 一 条 : 那 就 是 只 要 我 们 使 用 的 
字体 ， 包 括 我 们 用 来 显示 的 文本 或 者 不 显示 的 ， 都 必须 定义 这 些 字符 。 许 多 字体 并 
不 完全 显示 成 Unicode 字 符 集 。 下 面 的 网 站 含有 那些 的 确 支持 Unicode 的 字体 的 有 用 


信息 AM 
http://www.slovo.info/unifonts.htm 


我 们 可 以 成 功 的 提取 使 用 tahoma.ttf 字 体 。 实 际 上 ， 下 面 实例 中 我 们 将 使 用 该 字 
体 ，Tahoma 字 体 并 不 是 支持 Unicode 定 义 的 每 一 个 字符 。 因 此 ， 如 果 我 们 想 使 用 一 
种 特殊 的 字体 时 ， 就 得 必须 选 Unicode 中 一 种 相近 的 字体 来 代替 。 我 们 系统 上 都 安 
装 了 字体 Unicode MS (arialuni.ttf) 一 一 该 字体 完全 支持 Unicode 字 符 集 ， 尽 管 这 种 字 
体 的 定义 的 文件 特别 大 (大约 24M) 





16.8.2 字体 、iText 和 Java 


iText 依 照 PDF 规 格 来 处 理 字体 ， 这 就 对 使 用 PDF 文件 对 入 的 字体 来 处 理 文件 带 来 了 
非常 大 的 方便 性 ， 同 时 也 需要 自由 读 取 定 义 文 件 的 字体 。 


而 java 在 字体 类 中 汲取 了 部 分 字体 格式 的 大 部 分 细节 内 容 。 


在 iText 中 ， 为 支持 Graphics2D 的 实现 画图 功能 ， 实 现 从 Java 字 体 对 象 到 BaseFont 
对 象 的 映射 字体 对 象 是 非常 有 必要 的 。 这 就 是 FontMapper 接 口 所 扮演 的 角色 。 


如 果 我 们 使 用 缺 省 的 构建 器 构建 了 一 个 新 的 DefaultFontMapper 实 例 ， 那 么 总 会 带 
有 Java 规 格 定 义 的 本 地 字体 映射 。 但 是 如 果 我 们 想 使 用 其 他 一 些 字 字体 HAC 
必须 么 我 们 需要 将 其 他 的 字符 映射 加 入 到 
DefaultFontMapper 对 象 中 。 


16.8.3 映射 第 三 方 的 字体 


这 里 我 们 决定 使 用 Tahoma 字 体 来 显示 标题 。 该 字体 的 定义 文件 (tahoma.ttf) 在 我 们 
系统 下 面 的 目录 下 可 以 找到 。 








/opt/sun-jdk-1.4.2.08/jre/lib/fonts 


现在 我 们 使 用 代码 说 明 ， 使 用 iText 创 建 FontMapper 对 象 来 使 用 Tahoma 字 体 : 


// 设 置 字体 
DefaultFontMapper mapper = new DefaultFontMapper(); 
mapper.insertDirectory("D:NNjre1.5.0 10NNlibNNfonts"); 
DefaultFontMapper.BaseFontParameters pp - 
mapper.getBaseFontParameters("Tahoma") ; 
if (pp!=null) { 
pp.encoding = BaseFont.IDENTITY H; 
} 


现在 我 们 可 以 修改 创建 图 表 的 代码 ， 将 图 表 的 标题 使 用 该 字体 : 


TextTitle textTitle = chart.getTitle(); 

textTitle.setFont(new Font("Tahoma", Font.PLAIN, 20)); 

String text = "\u278A\uU20A0\U20A1\U20A2\U20A3\U20A4 \U20A5 \U20A6 \u2( 
// String text = "hi"; 

Font font = new Font("Tahoma", Font.PLAIN, 12); 

TextTitle subtitle = new TextTitle(text, font); 
chart.addSubtitle(subtitle); 





副标题 的 输出 如 下 图 16.2 所 示 。 实 例 已 经 嵌入 到 PDF 文 件 中 。 因 此 本 文 演示 的 该 小 
程序 很 好 的 展示 了 这 种 类 型 的 输出 ， 给 出 了 详细 的 步骤 指南 ， 便 于 我 们 正确 使 用 。 
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如 图 16.2 一 个 Unicode 副 标题 的 图 表 


17 导出 图 表 为 SVG 格式 


17.1 简介 


在 本 章 里 ， 我 们 介绍 了 一 个 简单 实例 ， 实 例 演示 使 用 JFreeChart 和 Batik 工 具 (SVG 
开源 的 类 库 ) 如 何 将 图 表 导 出 为 SVG 格式 。 


17.26 


17.2.1 什么 是 SVG? 


SVG( 可 放 缩 的 矢量 图 形 ) 是 W3C(World Wide Web ConSor 一 tium 国 际 互联 网 标准 
组 织 ) 在 2000 年 8 月 制定 的 一 种 基于 XML 格式 的 新 的 二 维 矢 量 图 形 格式 ， 也 是 规范 中 
的 网 络 矢量 图 形 标准 。 


17.2.2 Batik 


Batik 是 一 个 java 开 源 的 工具 包 ， 人 允许 我 们 产生 SVG 内 容 。 可 以 从 下 面 的 链接 获得 有 
效 的 Batik : 


http://xml.apache.org/batik 
在 写本 文 之 前 ，Batik 最 新 的 版 本 是 1.7 


17.3 实例 代码 


17.3.1 JFreeChart 和 Batik 


JFreeChart 和 Batik 兼 容 性 非常 好 ， 因 为 : 


e 因为 JFreeChart 画 的 所 有 图 表 的 输出 都 是 使 用 的 Java 的 Graphics2D ; 
e Batik 具 体 实现 了 Graphics2D 产 生 SVG 输 出 的 功能 (SVGGraphics2D) 。 


在 本 章节 ， 使 用 一 个 简单 的 实例 说 明 使 用 JFreeChart 和 Batik 实 现 SVG 的 输出 。 关 于 
该 实例 的 详细 技术 详 见 下 面 链 接 : 


http://xml.apache.org/batik/svggen.html 
17.3.2 开始 


首先 ， 我 们 需要 下 载 Batik 并 依照 网 站 的 指导 进行 安装 。 
确保 下 章节 的 例子 能 够 正常 运行 ， 需 要 将 下 面 的 jar 包 加 到 我 们 的 classpath : 





文件 描述 
jcommon-1.0.9.jar JFreeChart 的 通用 类 包 。 
jfreechart-1.0.6.jar JFreeChart 的 类 包 
batik-awt-util.jar Batik 实 时 运行 文件 
batik-dom.jar Batik 实 时 运行 文件 
batik-svggen jar Batik 实 时 运行 文件 
batik-util.jar Batik 实 时 运行 文件 


17.3.3 实例 应 用 


在 我 们 的 开发 环境 中 创建 一 个 工程 ， 并 且 将 上 节 列 出 的 jar 包 添加 到 工程 路 径 上 ， 并 
输入 下 面 代码 : 


package demo; 

import java.awt.geom.Rectangle2D; 

import java.io.File; 

import java.io.FileOutputStream; 

import java.io.IOException; 

import java.io.OutputStreamwriter; 

import java.io.Writer; 

import org.apache.batik.dom.GenericDOMImplementation; 
import org.apache.batik.svggen.SVGGraphics2D; 


import org.jfree.chart.ChartFactory; 
import org.jfree.chart.JFreeChart; 
import org.jfree.data.general.DefaultPieDataset; 
import org.w3c.dom.DOMImplementation; 
import org.w3c.dom.Document; 
s 
* A demonstration showing the export of a chart to SVG format. 
e 
public class SVGExportDemo { 
ses 
* Starting point for the demo. 
* 
* @param args 
* ignored. 
“y 
public static void main(String[] args) throws IOException í 
// create a dataset... 
DefaultPieDataset data = new DefaultPieDataset(); 
data.setValue("Category 1", new Double(43.2)); 
data.setValue("Category 2", new Double(27.9)); 
data.setValue( "Category 3", new Double(79.5)); 
// create a chart 
JFreeChart chart = ChartFactory.createPieChart("Sample Pie 
data, true, false, false); 
// THE FOLLOWING CODE BASED ON THE EXAMPLE IN THE BATIK DOC 
// Get a DOMImplementation 
DOMImplementation domImpl = GenericDOMImplementation 
.getDOMImplementation(); 
// Create an instance of org.w3c.dom.Document 
Document document = domImpl.createDocument(null, "svg", nu- 
// Create an instance of the SVG Generator 
SVGGraphics2D svgGenerator = new SVGGraphics2D(document); 
// set the precision to avoid a null pointer exception in E 
svgGenerator.getGeneratorContext().setPrecision(6); 
// Ask the chart to render into the SVG Graphics2D implemer 
chart.draw(svgGenerator, new Rectangle2D.Double(0, 0, 400, 
// Finally, stream out SVG to a file using UTF-8 character 
// byte encoding 
boolean useCSS - true; 
Writer out = new OutputStreamwriter(new FileOutputStream(ne 
"test.svg")), "UTF-8"); 
svgGenerator.stream(out, useCSS); 





17.3.4 浏览 SVG 图 


Batik 类 库 内 包含 了 一 个 "Squiggle” 的 小 应 用 ， 我 们 可 以 使 用 该 工具 浏览 SVG 文 件 。 
我 们 可 以 使 用 下 面 命令 打开 : 





JFreeChart 开发 者 指南 


java -jar batik-squiggle.jar 


下 图 截屏 显示 了 上 述 代 码 创 建 的 一 个 饼 图 的 界面 。 使 用 应 用 浏览 器 工具 ， 将 图 表 在 


浏览 器 中 进行 了 45 度 旋转 。 


Squiggle: test. syg HEL 
File Edit View Processing Go Tools ? 


€ | g JAR (a % | ë | 
局 Location: file:ziC:;:Documents and Settingsimxq/m fij‘test.svg v 





9 
% 


A 


ON | 
| 之 > A A 
hw: 590.43414 : -135.05739 
如 图 17.1 SVG 截图 








17.3 实例 代码 





18 Applet 


18.1 简介 


局 限于 一 UE 在 Applet 中 使 用 JFreeChart 还 是 比较 容易 的 。 本 章节 


对 Applet 进 


行 了 整体 的 介绍 ， 并 举例 说 明了 工作 过 程 。 这 样 对 我 们 开始 使 用 Applet 提 供 极 大 帮 


Bi). 


= oþh FAAA: demo. Appleti. class FEER 
Applet 
Memory Usage 


2,000,000 


1,500,000 4 


1,000,000 
M MNANINININININININNUNNIN 





0 - 
15:38:42 15:38:43 15:38:44 15:38:45 15:38:46 15:38:47 
Time 


— Total — Free 





小 程序 已 启动 。 


图 18.1 JFreeChart 在 Applet 上 的 应 用 


图 18.1 显 示 了 一 个 使 用 JFreeChart 的 Applet 简 单 应 用 。 该 applet 可 以 通 


看 效果 。 
http://www.object-refinery.com/jfreechart/applet.html 


后 面 的 章节 有 全 部 的 代码 。 


过 下 面 链接 


18.2 问题 


在 开发 applet 时 ， 考 虑 的 主要 问题 〈 与 JFreeChart 无 关 ) 是 : 


e 浏览 器 器 支持 
e 安全 约束 
e 字 节 码 文件 大 小 


在 我 们 用 提供 的 有 效 资源 写 applets 时 ， 确 保 我 们 对 上 面 问题 有 所 了 解 


18.2.1 浏览 器 支持 


绝 大 部 分 的 web 浏 览 器 均 对 最 新 版 本 的 JDK1.5 提 供 支持 ， 因 此 使 用 JFreeChart 运 行 
applets 也 是 绝对 没有 任何 问题 的 JFreeChart 可 以 运行 在 JDK1.3.1 版 本 或 以 上 版 
本 ) 。 尽 管 如 此 ， 很 大 一 部 分 用 户 还 是 使 用 一 个 浏览 器 的 一 一 微软 的 IE 浏 览 器 一 一 
该 浏览 器 仅仅 支持 JDK1.1 版 本 ， 并 且 现 在 已 经 过 期 。 这 里 有 一 个 问题 是 ， 使 用 
JFreeChart 的 applet 应 用 在 微软 的 IE 上 是 不 能 默认 运行 的 。 这 就 必须 下 载 一 个 Java 
的 插件 ， 但 是 这 样 会 造成 很 多 不 必要 的 麻烦 和 困难 ， 最 终 的 问题 就 是 那些 开发 者 选 
择 写 applets 开 发 的 问题 ， 这 导致 开发 者 放弃 开发 applets， 而 选择 Java 

Servlets ( 见 下 一 章节 ) 。 


18.2.2 安全 


Applets 设 计时 ， 是 符合 java 安 全 规范 的 。 当 一 个 applet 运 行 在 我 们 的 web 浏 览 器 上 
时 ， 在 操作 上 是 受到 很 大 的 约束 的 。 例 如 ， 一 个 applet 典 型 的 是 不 能 读 写 本 地 文件 
系统 的 。 关 于 Java 安 全 机 制 的 描述 已 经 超出 了 本 章 的 范围 ， 但 是 我 们 必须 意识 到 
JFreeChart 的 一 些 功能 在 applets 上 是 不 能 运行 的 (例如 将 图 表 保 存 成 PNG 格 式 的 文 
件 ) ， 主 要 受 java 缺 省 的 安全 规则 约束 。 如 果 我 们 想 使 用 这 些 功能 ， 那 么 我 们 需要 
认真 学 习 一 下 java 的 安全 机 制 的 更 多 细节 。 


18.2.3 代码 大 小 


最 后 一 个 文件 就 是 我 们 applet 运 行 时 需要 的 代码 量 问题 。 在 我 们 运行 一 个 applet 之 

前 ， 代 码 被 下 载 到 本 地 客户 端 。 显 然 对 用 户 来 说 是 有 带宽 限制 的 ， 代 码 量 的 大 小 成 
了 关键 问题 。JFreeChart 代 码 的 jar 文 件 大 约 是 1M 左 右 ， 对 JFreeChart 支 持 的 图 表 

来 说 ， 不 算 很 大 ， 但 对 使 用 modem 找 号 上 网 的 用 户 来 说 ， 的 确 不 是 很 理想 的 。 同 时 
我 们 需要 将 JCommon 的 jar 包 (大 约 290KB) 加 到 我 们 的 applet 上 。 考 虑 到 这 些 问 

题 ， 我 们 将 对 JFreeChart 进 行 重新 打包 ， 奴 仅 将 applet 需 要 的 类 文件 包含 进来 ， 从 
而 优化 代码 结构 。 


18.3 实例 应 用 


正如 在 简介 中 所 提 及 的 ， 使 用 JFreeChart 的 applet 可 以 在 下 面 链接 中 看 到 : 
http://www.object-refinery.com/jfreechart/applet.html 


运行 applet 应 用 时 ， 需 要 两 个 方面 俄 支 持 。 一 是 代码 方式 创建 applet， 二 是 HTML 文 
件 用 来 调用 applet。 


18.3.1 HTML 


因为 applet 需 要 引入 额外 的 jar 文 件 ， 所 以 在 HTML 中 使 用 applet 是 显得 非常 重要 。 
HTML applet 标 签 如 下 : 


<APPLET ARCHIVE="jfreechart-1.0.6-applet-demo. jar, 
jfreechart-1.0.6.jar, jcommon-1.0.9.jar" 
CODE="demo.applet.Appleti" width=640 height=260 
ALT="You should see an applet, not this text."> 
</APPLET> 


注意 这 里 有 三 个 jar 需 要 引入 ， 第 一 个 包含 了 applet 类 ， 另 外 两 个 jar 文 件 是 
JFreeChart 和 JCommon 类 库 。 我 们 需要 在 HTML 文 件 中 将 applet 标 签 引 入 。 


18.3.2 源 代 码 


实例 applet 的 源 代 码 见 下 〈 代 码 中 我 们 使 用 了 很 少 的 applet 特 殊 的 代码 ， 仅 仅 扩展 
了 JApplet) 


package demo; 

import java.awt.BasicStroke; 

import java.awt.Color; 

import java.awt.event.ActionEvent; 

import java.awt.event.ActionListener; 

import javax.swing.JApplet; 

import javax.swing.Timer; 

import org.jfree.chart.ChartPanel; 

import org.jfree.chart.JFreeChart; 

import org.jfree.chart.axis.DateAxis; 

import org.jfree.chart.axis.NumberAxis; 

import org.jfree.chart.plot.XYPlot; 

import org.jfree.chart.renderer.xy.XYItemRenderer; 
import org.jfree.chart.renderer.xy.XYLineAndShapeRenderer; 
import org.jfree.data.time.Millisecond; 

import org.jfree.data.time.TimeSeries; 

import org.jfree.data.time.TimeSeriesCollection; 
ffs 


* A simple applet demo. 


272 


public class Appleti extends JApplet { 


ff hte 


Time series for total memory used. */ 


private TimeSeries total; 


EXER 


Time series for free memory. */ 


private TimeSeries free; 


VASE 


* Creates a new instance. 


SA 


public Appleti() í 


} 
[Pike 


// create two series that automatically discard data more 1 
// 30 seconds old... 

this.total = new TimeSeries("Total", Millisecond.class); 
this.total.setMaximumItemAge (30000); 

this.free - new TimeSeries("Free", Millisecond.class); 
this.free.setMaximumItemAge (30000); 

TimeSeriesCollection dataset - new TimeSeriesCollection(); 
dataset.addSeries(total); 

dataset.addSeries(free); 

DateAxis domain - new DateAxis("Time"); 

NumberAxis range - new NumberAxis("Memory"); 
XYItemRenderer renderer - new XYLineAndShapeRenderer(true, 
XYPlot plot - new XYPlot(dataset, domain, range, renderer), 
plot.setBackgroundPaint(Color.lightGray); 
plot.setDomainGridlinePaint(Color.white); 
plot.setRangeGridlinePaint(Color.white); 
renderer.setSeriesPaint(0, Color.red); 
renderer.setSeriesPaint(1, Color.green); 
renderer.setSeriesStroke(0, new BasicStroke(1.5f)); 
renderer.setSeriesStroke(1, new BasicStroke(1.5f)); 
domain.setAutoRange(true); 

domain.setLowerMargin(0.0); 

domain.setUpperMargin(0.0); 
domain.setTickLabelsVisible(true); 
range.setStandardTickUnits(NumberAxis.createIntegerTickUni! 
JFreeChart chart = new JFreeChart("Memory Usage", 
JFreeChart.DEFAULT TITLE FONT, plot, true); 
chart.setBackgroundPaint(Color.white); 

ChartPanel chartPanel - new ChartPanel(chart); 
chartPanel.setPopupMenu(null); 
getContentPane().add(chartPanel); 

new Appleti.DataGenerator().start(); 


Adds an observation to the 'total memory' time series. 


Qparam y 


* the total memory used. 


rd 


private void addTotalObservation(double y) { 


j 


total.add(new Millisecond(), y); 


fore 

* Adds an observation to the 'free memory’ time series. 

* 

* param y 

* the free memory. 

n 

private void addFreeObservation(double y) { 
free.add(new Millisecond(), y); 

} 


Ce 
* The data generator. 
ud 
class DataGenerator extends Timer implements ActionListener { 
PEK 
* Constructor. 
rye 
DataGenerator() ( 
super(100, null); 
addActionListener(this); 
} 
ASE 
* Adds a new free/total memory reading to the dataset. 
* 
* @param event 
* the action event. 
2 
public void actionPerformed(ActionEvent event) ( 
long f - Runtime.getRuntime().freeMemory(); 
long t - Runtime.getRuntime().totalMemory(); 
addTotalObservation(t); 
addFreeObservation(f); 





19 Servlets 


19.1 介绍 


Java Servlet APl 是 一 套 创建 web 应 用 非常 流行 成 熟 的 技术 。 在 servlet 环 境 中 使 用 
JFreeChart 是 非常 合适 的 。 在 本 章节 中 ， 协 助 开 发 者 在 web 应 用 中 使 用 
JFreeChart。 本 章 所 有 的 实例 可 以 从 下 面 链接 中 下 载 : 


http://www.object-refinery.com/jfreechart/premium/index.html 


下 载 的 文件 名 为 : jfreechart-1.0.6-demo.zip (该 信息 是 收费 的 ) . 


19.2 编写 一 个 简单 的 Servlet y; FB 


ServletDemo1 类 实现 了 一 个 非常 简单 的 servlet， 该 servlet 返 回 了 一 个 PNG 图 ， 
PNG 图 是 使 用 JFreeChart 生 成 的 直方 条 形 图 表 。 当 运行 该 程序 时 ，servlet 在 客户 端 
仅仅 显示 一 幅 图 片 ， 而 没有 任何 的 HTML 修 饰 ， 参 见 下 图 19.1。 


$ http://localhost:8080/jfreecharti1/servlet/Servl. . - FEER 
THE) RE) SEW KEA IR(D Raw Ed 
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如 图 19.1 浏览 器 中 的 servlet 效 果 
我 们 以 这 种 方式 显示 图 片 ， 是 没有 特殊 意义 ， 仅 仅 是 为 了 : 


e 很 好 演示 servlets 的 请 求 一 响应 交互 特征 ; 
e 作为 测 j 试 实例 非常 有 用 ， 我 们 会 了 解 如 何 配置 一 个 服务 环境 ， 如 何 让 页 面 控件 
工作 。 


我 们 可 以 浏览 后 面 更 复杂 的 实例 ， 显 示 使 用 HMTL 表 单 如 何 请 求 不 同 的 图 表 ， 并 且 
将 产生 的 图 表 的 输出 植 入 到 HTML 中 。 下 面 是 基本 serviet 的 代码 。 


package demo; 

import java.io.IOException; 

import java.io.OutputStream; 

import javax.servlet.ServletException; 

import javax.servlet.http.HttpServlet; 

import javax.servlet.http.HttpServletRequest; 
import javax.servlet.http.HttpServletResponse; 


import org.jfree.chart.ChartFactory; 

import org.jfree.chart.ChartUtilities; 

import org.jfree.chart.JFreeChart; 

import org.jfree.chart.plot.PlotOrientation; 

import org.jfree.data.category.DefaultCategoryDataset; 

JESSE 

* A basic servlet that returns a PNG image file generated by JFree( 
* class is described in the JFreeChart Developer Guide in the "Ser 


* chapter. 

a 

public class ServletDemo1 extends HttpServlet { 
Yh to 
* Creates a new demo. 
A 


public ServletDemoi() { 
// nothing required 

j 

fee 

Processes a GET request. 


* 


Qparam request 
the request. 
Qparam response 
the response. 


Qthrows ServletException 

if there is a servlet related problem. 
Qthrows IOException 

if there is an I/O problem. 


+ x FF OR OR FF F ooo F 


i^ 
public void doGet(HttpServletRequest request, HttpServletRespor 
throws ServletException, IOException { 
OutputStream out = response.getOutputStream(); 
try { 
DefaultCategoryDataset dataset = new DefaultCategoryDat 
dataset.addValue(10.0, "Si", "C1"); 
dataset.addValue(4.0, "S1", "C2"); 
dataset.addValue(15.0, "Si", "C3"); 
dataset.addValue(14.0, "Si", "C4"); 
dataset.addValue(-5.0, "S2", "C1"); 
dataset.addValue(-7.0, "S2", "C2"); 
dataset.addValue(14.0, "S2", "C3"); 
dataset.addValue(-3.0, "S2", "C4"); 
dataset.addValue(6.0, "S3", "C1"); 
dataset.addValue(17.0, "S3", "C2"); 
dataset.addValue(-12.0, "S3", "C3"); 
dataset.addValue(7.0, "S3", "C4"); 
dataset.addValue(7.0, "S4", "C1"); 


dataset.addValue(15.0, "S4", "C2"); 
dataset.addValue(11.0, "S4", "C3"); 
dataset.addValue(0.0, "S4", "C4"); 
dataset.addValue(-8.0, "S5", "C1"); 
dataset.addValue(-6.0, "S5", "C2"); 


dataset.addValue(10.0, "S5", "C3"); 
dataset.addValue(-9.0, "S5", "C4"); 
dataset.addValue(9.0, "S6", "C1"); 
dataset.addValue(8.0, "S6", "C2"); 
dataset.addValue(null, "S6", "C3"); 
dataset.addValue(6.0, "S6", "C4"); 
dataset.addValue(-10.0, "S7", "C1"); 
dataset.addValue(9.0, "S7", "C2"); 
dataset.addValue(7.0, "S7", "C3"); 
dataset.addValue(7.0, "S7", "C4"); 
dataset.addValue(11.0, "S8", "C1"); 
dataset.addValue(13.0, "S8", "C2"); 
dataset.addValue(9.0, "S8", "C3"); 
dataset.addValue(9.0, "S8", "C4"); 
dataset.addValue(-3.0, "S9", "C1"); 
dataset.addValue(7.0, "S9", "C2"); 
dataset.addValue(11.0, "S9", "C3"); 
dataset.addValue(-10.0, "S9", "C4"); 


JFreeChart chart - ChartFactory.createBarChart("Bar Ch: 
"Category", "Value", dataset, PlotOrientation.VERT: 
true, true, false); 

response.setContentType("image/png"); 

ChartUtilities.writeChartAsPNG(out, chart, 

) catch (Exception e) { 

System.err.println(e.toString()); 

} finally { 
out.close(); 


400, 300); 


Ea wa 





是 一 个 web 济 览 器 ) 发 出 一 个 请 求 时 ，Servlet 引 擎 调用 
请 求 ，servlet 执 行 下 面 几 步 : 


个 输出 流 引 用 


当 一 个 客户 端 (通常 
DoGet() 方 法 ， 以 响应 这 个 


为 客户 端 返回 的 输出 获得 一 
创建 一 个 图 表 ; 
响应 的 内 容 类 型 设置 为 image/png， 这 告诉 客户 端 接 受 的 数据 类 型 是 什 
一 个 图 表 的 PNG 图 表 beii 写 进 输出 流 ; 

输 出 流 关 Alo 


19.3 编译 实例 Servlet 


注意 在 javax.servlet.* 包 (包括 子 包 ) 内 的 类 ， 也 就 是 实例 使 用 的 servlet， 并 不 是 
J2SE 的 一 部 分 。 为 了 使 用 J2SE 编 译 上 面 的 代码 需要 另 一 个 jar 文 件 servletjar。 我 们 
使 用 了 tomcat (是 用 java 编 写 的 一 个 开源 servlet 引 擎 ) 版 本 下 面 的 这 个 servlet.jar 文 
件 。Tomcat 可 以 在 下 面 链接 中 获得 : 


http://tomcat.apache.org/ 


同时 我 们 需要 JFreeChat 和 JCommon 两 个 类 包 文 件 来 编译 上 面 的 代码 。 改 变 我 们 当 
前 的 工作 目录 ， 输 入 下 面 的 命令 〈 如 果 在 Windows 上 ， 你 需要 将 冒号 ″ : “更 改 为 分 


mB"; “) 


javac -classpath jfreechart-1.0.6.jar:lib/jcommon-1.0.9.jar:lib/se! 
source/demo/ServletDemo1. java 





这 样 就 生成 了 一 个 ServletDemo1.class 文 件 ， 下 一 章 内 容 描述 了 如 何 使 用 Tomcat 部 
署 这 个 servlet。 


19.4 部 署 实例 Servlet 


Servlets 部 署 在 我 们 服务 引擎 的 webapps 的 目录 下 面 ， 在 我 们 的 例子 中 ， 使 用 的 是 
Tomcat 5.5.20， 将 代码 部 署 在 : 


D:\apache-tomcat-5.5.20\webapps\jfreechart1 


在 webapp 目 录 下 ， 创 建 一 个 目录 jfreechart1 来 存放 servlet 演 示 实 例 ， 然 后 创建 下 面 
的 结构 目录 。 


.../jfreecharti/WEB-INF/web. xml 
.../jfreecharti/WEB-INF/1lib/jfreechart-1.0.6.jar 
... /jfreechart1/WEB-INF/lib/jcommon-1.0.9.jar 

.. /jfreechart1/WEB-INF/classes/demo/ServletDemoi1.class 


我 们 需要 创建 web.xml 文 件 一 一 提供 servlet 的 信息 。 


<?xml version="1.0" encoding="IS0-8859-1"?> 
<!DOCTYPE web-app 
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN" 
"http://java.sun.com/j2ee/dtds/web-app_2.2.dtd"> 
«web - app» 
<servlet> 
<servlet -name>ServletDemoi</servlet -name> 
<servlet-class>demo.ServletDemoi</servlet-class> 
</servlet> 
<servlet -mapping> 
<servlet -name>ServletDemoi</servlet -name> 
<url-pattern>/servlet/ServletDemoi</url-pattern> 
</servlet -mapping> 
</web-app> 


一 旦 上 面 的 文件 部 署 在 servlet 服 务 引 敬 上， 然后 和 启动 我 们 的 servlet 服 务 引擎 ， 在 
Web 浏 览 器 中 输入 下 面 的 地 址 : 


http://localhost:8080/jfreechart1/servlet/ServletDemo1 
如 果 不 出 现 意外 ， 我 们 就 会 在 浏览 器 中 看 到 如 图 19.1 所 示 的 界面 。 


19.5 在 HMTL 7i ARA E] s= 


在 HTML 5i EPEA servlet FN E] 2 p] fI t ze RT EARS, PEX #llServietDemo2;8 
示 了 这 一 特征 。ServletDemo2 实 例 处 理 一 个 HTML 页 面 的 请 求 ， 该 HTML 引 用 了 另 
一 个 servlet (ServletDemo2ChartGenerator) ， 引 用 的 这 个 servlet 返 回 了 一 个 图 表 
产生 的 PNG 图 像 。 最 终 的 结果 就 是 将 图 表 柑 入 到 了 一 个 HTML 中 ， 如 图 19.2 所 示 : 


$ JFreeChart Servlet Demo 2 — Microsoft Internet Explorer TER) 
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如 图 19.2 浏览 器 中 的 ServletDemo2 
全 部 代码 如 下 : 


package demo; 

import java.io.IOException; 

import java.io.Printwriter; 

import javax.servlet.ServletException; 
import javax.servlet.http.HttpServlet; 


import javax.servlet.http.HttpServletRequest; 

import javax.servlet.http.HttpServletResponse; 

ates 

* A basic servlet that generates an HTML page that displays a chart 


* by JFreeChart. 
* &lt;P&gt; 
* This servlet uses another servlet (ServletDemo2ChartGenerator) 七 
* PNG image for the embedded chart. 
* &lt;P&gt; 
* This class is described in the JFreeChart Developer Guide. 
u^ 
public class ServletDemo2 extends HttpServlet { 
ff its 
* 
i 
private static final long serialVersionUID = 90240404676979098! 
JESS 
* Creates a new servlet demo. 
VÉ 


public ServletDemo2() { 
// nothing required 
} 


sess 
* Processes a POST request. 

&lt;P&gt; 

The chart.html page contains a form for generating the first 
after that the HTML returned by this servlet contains the sar 
generating subsequent requests. 


Qparam request 
the request. 
Qparam response 
the response. 


Qthrows ServletException 

if there is a servlet related problem. 
Qthrows IOException 

if there is an I/O problem. 


ÓÉo oo ob FF Oo FF FF 0o ooo ooo oko HF F 


i^ 
public void doPost(HttpServletRequest request, HttpServletResp: 
throws ServletException, IOException { 
Printwriter out = new PrintWriter(response.getWriter()); 
try { 
String param = request.getParameter("chart"); 
response.setContentType("text/htm1"); 
out.println("«HTML»"); 
out.println("«HEAD»"); 
out.println("«TITLE»JFreeChart Servlet Demo 2«/TITLE»": 
out.println("«/HEAD»"); 
out.println("«BODY»"); 
out.printin("<H2>JFreeChart Servlet Democ/H2»"); 
out.println("«P»"); 
out.println("Please choose a chart type:"); 


out.printin( "<FORM ACTION=\"ServletDemo2\" METHOD-POST: 

String pieChecked (param.equals("pie") ? " CHECKED" 

String barChecked (param.equals("bar") ? " CHECKED" 

String timeChecked = (param.equals("time") ? " CHECKED' 

out.println("«INPUT TYPE=\"radio\" NAME=\"chart\" VALUE 
+ pieChecked + "> Pie Chart"); 

out.printin( "<INPUT TYPE=\"radio\" NAME=\"chart\" VALUE 
+ barChecked + "> Bar Chart"); 

out.printin( "<INPUT TYPE=\"radio\" NAME=\"chart\" VALUE 
+ timeChecked + "> Time Series Chart"); 

out.println("«P»"); 

out.println("«INPUT TYPE=\"submit\" VALUE=\"Generate CI 

out.println("«/FORM»"); 

out.println("<P>"); 

out.println("<IMG SRC=\"ServletDemo2ChartGenerator?type 
+ "N" BORDER=1 WIDTH-400 HEIGHT=300/>"); 

out.println("</BODY>"); 

out.println("</HTML>"); 

out.flush(); 

out.close(); 

} catch (Exception e) { 
System.err.println(e.toString()); 
} finally { 
out.close(); 





注意 该 代码 是 如 何 从 响应 的 参数 获得 一 个 引用 的 ， 而 不 是 上 面 实例 中 的 一 个 输出 
流 。 愿 意 是 因为 该 servlet 将 返回 HTML 文 本 ， 与 前 章 返 回 的 二 进 制 数 据 (一 个 PNG 
AA) 不 同 。 响 应 的 类 型 设置 成 为 text/html 格 式 ， 因 为 servlet 返 回 的 是 HTML 文 
件 。 重 要 的 一 点 就 是 HTML 引 用 另 一 个 servlet (ServletDemo2ChartGenerator) 中 
的 <IMG> 标 签 ，ServletDemo2ChartGenerator 创 建 了 必要 的 图 表 图 片 。HTML 使 用 
<FORM> 元 素来 建立 图 表 参 数控 制 着 实际 图 表 的 返回 。 


下 面 是 ServletDemo2ChartGenerator 的 全 部 代码 : 


package demo; 

import java.io.IOException; 

import java.io.OutputStream; 

import javax.servlet.ServletException; 

import javax.servlet.http.HttpServlet; 

import javax.servlet.http.HttpServletRequest; 
import javax.servlet.http.HttpServletResponse; 
import org.jfree.chart.ChartFactory; 

import org.jfree.chart.ChartUtilities; 

import org.jfree.chart.JFreeChart; 

import org.jfree.chart.plot.PlotOrientation; 
import org.jfree.data.category.DefaultCategoryDataset; 
import org.jfree.data.general.DefaultPieDataset; 


import org.jfree. 
import org.jfree. 


import org.jfree 


import org.jfree. 
import org.jfree. 


JESSE 

* A servlet that 
is referenced 
&lt;P&gt; 
Three differen 
The possible v 
&lt;P&gt; 

This class is 


+ FF FF 8. 2 


S 

public class Ser 
Va 
* Default co 
T 
public Servl 

// nothi 

J 


VASE 
* 


Process a 


Qparam req 
the reques 
Qparam res 
the respon 


@throws Se 
if there i 
Qthrows IO 
if there i 
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rd 


data.time.Day; 
data.time.TimeSeries; 
.data.time.TimeSeriesCollection; 
data.xy.XYDataset; 
date.SerialDate; 


returns one of three charts as a PNG image file. 
in the HTML generated by ServletDemo2. 


t charts can be generated, controlled by the ‘type’ 
alues are 'pie', 'bar' and 'time' (for time series: 


described in the JFreeChart Developer Guide. 
vletDemo2ChartGenerator extends HttpServlet { 
nstructor. 

etDemo2ChartGenerator() { 

ng required 

GET request. 

uest 

te 

ponse 

se. 

rvletException 

s a servlet related problem. 


Exception 
s an I/O problem. 


public void doGet(HttpServletRequest request, HttpServletRespor 
throws ServletException, IOException { 


Outputst 


try í 
Stri 


ream out = response.getOutputStream(); 


ng type = request.getParameter("type"); 


JFreeChart chart = null; 


if ( 


type.equals("pie")) { 


chart = createPieChart(); 

} else if (type.equals("bar")) í 
chart = createBarChart(); 

} else if (type.equals("time")) { 
chart = createTimeSeriesChart(); 


j 
if (chart != null) { 


response.setContentType("image/png"); 


ChartUtilities.writeChartAsPNG(out, chart, 400, 30( 


j 
) catch 


(Exception e) { 


System.err.println(e.toString()); 


} finally { 
out.close(); 
} 


} 

ER 

* Creates a sample pie chart. 

* 

* @return a pie chart. 

ae 

private JFreeChart createPieChart() { 
// create a dataset... 
DefaultPieDataset data = new DefaultPieDataset(); 
data.setValue("One", new Double(43.2)); 
data.setValue("Two", new Double(10.0)); 
data.setValue("Three", new Double(27.5)); 
data.setValue("Four", new Double(17.5)); 
data.setValue("Five", new Double(11.0)); 
data.setValue("Six", new Double(19.4)); 
JFreeChart chart - ChartFactory.createPieChart("Pie Chart", 

true, false); 

return chart; 

} 

/ EXER 

* Creates a sample bar chart. 

* 

* @return a bar chart. 

i 

private JFreeChart createBarChart() { 
DefaultCategoryDataset dataset = new DefaultCategoryDatasel 
dataset.addValue(10.0, "Si", "C1"); 
dataset.addValue(4.0, "S1", "C2"); 
dataset.addValue(15.0, "Si", "C3"); 
dataset .addValue(14.0, "S1", "C4"); 
dataset.addValue(-5.0, "S2", "C1"); 
dataset.addValue(-7.0, "S2", "C2"); 
dataset.addValue(14.0, "S2", "C3"); 
dataset.addValue(-3.0, "S2", "C4"); 
dataset.addValue(6.0, "S3", "C1"); 
dataset.addValue(17.0, "S3", "C2"); 
dataset.addValue(-12.0, "S3", "C3"); 
dataset.addValue(7.0, "S3", "C4"); 
dataset.addValue(7.0, "S4", "C1"); 
dataset.addValue(15.0, "S4", "C2"); 
dataset.addValue(11.0, "S4", "C3"); 
dataset.addValue(0.0, "S4", "C4"); 
dataset.addValue(-8.0, "S5", "C1"); 
dataset.addValue(-6.0, "S5", "C2"); 
dataset.addValue(10.0, "S5", "C3"); 
dataset.addValue(-9.0, "S5", "C4"); 
dataset.addValue(9.0, "S6", "C1"); 
dataset.addValue(8.0, "S6", "C2"); 
dataset.addValue(null, "S6", "C3"); 
dataset.addValue(6.0, "S6", "C4"); 


dataset.addValue(-10.0, "S7", "C1"); 
dataset.addValue(9.0, "S7", "C2"); 
dataset.addValue(7.0, "S7", "C3"); 
dataset.addValue(7.0, "S7", "C4"); 
dataset.addValue(11.0, "S8", "C1"); 
dataset.addValue(13.0, "S8", "C2"); 
dataset.addValue(9.0, "S8", "C3"); 
dataset.addValue(9.0, "S8", "C4"); 
dataset.addValue(-3.0, "S9", "C1"); 
dataset.addValue(7.0, "S9", "C2"); 
dataset.addValue(11.0, "S9", "C3"); 
dataset.addValue(-10.0, "S9", "C4"); 

JFreeChart chart = ChartFactory.createBarChart3D("Bar Chart 
"Category", "Value", dataset, PlotOrientation.VERTICAL, 
true, false); 

return chart; 

J 

jf eis 

* Creates a sample time series chart. 

* 

* @return a time series chart. 

2 

private JFreeChart createTimeSeriesChart() { 

// here we just populate a series with random data... 

TimeSeries series = new TimeSeries("Random Data"); 

Day current = new Day(1, SerialDate.JANUARY, 2001); 

for (int i = 0; i &lt; 100; i++) í 
series.add(current, Math.random() * 100); 
current = (Day) current.next(); 

} 

XYDataset data = new TimeSeriesCollection(series); 

JFreeChart chart - ChartFactory.createTimeSeriesChart( 
"Time Series Chart", "pate", "Rate", data, true, true, 

return chart; 





下 一 章 讲 述 servlet 的 支持 文件 ， 与 如 何 部 署 它 们 。 


19.6 支持 文件 


Servlet 为 客户 端 产 生 典 型 的 输出 。 大 部 分 web 上 应 用 之 少 包含 一 个 HTML 文 件 ， 用 来 
进入 应 用 的 入 口 。 本 章 演 示 的 servlet， 使 用 index.html 页 面 ， 代 码 如 下 : 


<HTML> 
<HEADER> 
<TITLE>JFreeChart : Basic Servlet Demo</TITLE> 
</HEADER> 
<BODY> 
<H2>JFreeChart: Basic Servlet Demo</H2> 
<P>There are two sample servlets available: 
<ul> 
<li>a very basic servlet to generate a <a 
href="servlet/ServletDemoi">bar chart;«/li» 
<li>another servlet that allow you to select one of <a 
href="chart.html">three sample charts. The selected chart : 
displayed in an HTML page.</1li> 
</ul> 
</BODY> 
</HTML> 





该 页 面 上 有 两 个 链接 ， 一 个 是 实例 1 (ServletDemo1) ， 第 二 个 链接 是 两 一 个 
HTML 页 面 ，chart.html。 代 码 如 下 : 


<HTML> 
<HEADER> 
<TITLE>JFreeChart Servlet Demo 2</TITLE> 
</HEADER> 
<BODY> 
<H2>JFreeChart Servlet Demo</H2> 
<P>Please choose a chart type: 
<FORM ACTION="Servlet/ServletDemo2" METHOD=POST> 
<INPUT TYPE-"radio" NAME-"chart" VALUE-"pie" CHECKED» Pie ( 
<INPUT TYPE="radio" NAME-"chart" VALUE-"bar"» Bar Chart 
«INPUT TYPE-"radio" NAME-"chart" VALUE-"time"» Time Series 
<INPUT TYPE="Submit" VALUE="Generate Chart"> 
</FORM> 
</BODY> 
</HTML> 


ELLE eo: SETE. 
第 二 个 HTML 页 面包 含 <FORM> 元 素 用 来 为 第 二 个 serlvet 指 定 一 个 参数 。 当 servlet 


运行 时 ， 返 回 自己 的 HTML，THML 包 含 一 个 <IMG> 元 素 ， 该 元 素 引 用 了 
ServletDemo2ChartGenerator 的 servlet。 





19.7 部 署 Servlets 


完成 上 面 实例 代码 的 编译 厚 ， 需 要 将 它们 连同 支持 文档 部 署 到 servlet 引 擎 上 ， 以 便 
于 客户 端 能 够 正确 访问 。 幸 运 的 是 ， 这 些 都 非常 容易 做 到 。 


首先 是 配置 web.xml 文 件 ， 该 文件 用 来 描述 web 应 用 部 署 。 


<?xml version="1.0" encoding="IS0-8859-1"7> 
<!DOCTYPE web-app 
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN" 
"http://java.sun.com/j2ee/dtds/web-app_2.2.dtd"> 
«web - app» 
«servlet» 
<servlet -name>ServletDemo1</servlet -name> 
<servlet-class>demo.ServletDemoi</servlet-class> 
</servlet> 
<servlet> 
<servlet -name>ServletDemo2</servlet -name> 
<servlet-class>demo.ServletDemo2</servlet-class> 
</servlet> 
<servlet> 
<servlet -name>ServletDemo2ChartGenerator</servlet -name> 
«servlet-class»demo.ServletDemo2ChartGenerator«/servlet-cl: 
«/servlet» 
«servlet-mapping» 
<servlet -name>ServletDemo1</servlet -name> 
<url-pattern>/servlet/ServletDemoi</url-pattern> 
</servlet -mapping> 
<servlet -mapping> 
<servlet -name>ServletDemo2</servlet -name> 
<url-pattern>/servlet/ServletDemo2</url-pattern> 
</servlet -mapping> 
<servlet -mapping> 
<servlet -name>ServletDemo2ChartGenerator</servlet -name> 
<url-pattern>/servlet/ServletDemo2ChartGenerator</url-patte 
</servlet -mapping> 
</web-app> 


Rim ass) 


该 文件 通过 名 字 列 出 了 全 部 的 sevlets， 并 且 指 定 了 具体 类 。 实 际 的 类 被 放置 在 
servlet 引 擎 的 指定 目录 下 面 。 


最 后 的 步骤 是 将 全 部 的 文档 拷贝 到 响应 的 servlet 引 擎 的 目录 下 面 。 我 们 使 用 的 是 
servlet 引 擎 是 Tomcat。 在 Tomcat 下 的 webapps 目 录 下 面 创建 一 个 jfreechart2 的 目 
录 ， 将 index.html 和 chart.html 文 件 拷贝 到 下 面 的 目录 : 





webapps/jfreechart2/index. html 
webapps/jfreechart2/chart.html 


接 下 来 ， 在 目录 jfreechart2 下 建立 一 个 子 目 录 WEB-INFO， 将 web.xml 文 件 拷贝 到 该 
目录 下 面 。 


webapps/jfreechart2/WEB-INF/web.xml 


WEB-INFOHB x Fmt) 27 E x classes/demo' 25 3 B 3 BUE > El # FII 


webapps/jfreechart2/WEB-INF/classes/demo/ServletDemoi1.class 
webapps/jfreechart2/WEB-INF/classes/demo/ServletDemo2.class 
webapps/jfreechart2/WEB- INF/classes/demo/ServletDemo2ChartGeneratoi 





最 后 ， 将 相关 的 jar 找 贝 到 下 面目 录 : 


webapps/jfreechart2/WEB-INF/lib/jcommon-1.0.9.jar 
webapps/jfreechart2/WEB-INF/lib/jfreechart-1.0.6.jar 


现在 启动 我 们 的 servlet 引 擎 ， 在 我 们 的 浏览 器 中 输入 : 
http://localhost:8080/jfreechart2/index.html 


如 果 全 部 文件 放置 在 适当 位 置 ， 而 不 出 现 特殊 意外 的 话 ， 我 们 将 会 看 到 上 面 图 19.2 
所 示 的 界面 。 


20 JFreeChart 相 关 技 术 


20.1 简介 


本 章节 主要 介绍 了 JFreeChart 涉 及 的 各 种 信息 


20.2 X11/Headless Java 


如 果 我 们 在 Unix/Linux 上 的 服务 环境 使 用 JFreeChart， 我 们 会 遇 到 JFreeChart 在 没 
有 X11 的 情况 下 不 能 运行 。 这 与 运行 在 AWT 上 的 java 代 码 是 同一 个 问题 。 更 多 的 信 
息 见 下 面 链接 : 
http://java.sun.com/products/java-media/2D/forDevelopers/java2dfaq.html#xvfb 
同时 在 JFreeChart 的 论坛 里 面 也 有 好 多 的 信息 ， 可 以 找到 一 些 额外 的 思 


http://www. jfree.org/phpBB2/viewtopic.php?t=1012 


20.3 JSP 


如 果 开 发 者 在 JSP 中 使 用 JFreeChart 比 较 感 兴趣 ， 那 么 可 以 从 下 面 网 址 找到 更 多 信 
EB. 


AUN = 


http://cewolf.sourceforge.net/ 


20.4 加 载 图 片 


图 像 在 Java 中 是 用 Image 来 描述 的 。 我 们 可 以 使 用 开发 包 里 面 的 createlmage() 方 法 
来 创建 图 像 ， 但 是 我 们 需要 意识 到 该 方法 加 载 图 像 时 不 是 同步 的 一 换 句 话说 ， 方 
法 返回 的 与 图 像 加 载 是 在 不 同 的 线程 中 。 这 样 会 产生 这 样 一 个 问题 就 是 在 图 像 为 完 
全 加 载 完成 时 ， 我 们 就 使 用 了 该 图 像 。 


我 们 可 以 使 用 MediaTracker 类 来 检查 图 像 加 载 的 进度 。 但 万 一 在 某 个 地 方 我 们 需要 
在 使 用 方法 之 前 ， 必 须 确 保 图 片 完 全 加 载 完 毕 。 这 时 该 怎么 办 呢 ? 使 用 Swing 的 
Imagelcon 类 可 以 解决 我 们 这 个 问题 ， 代 码 如 下 : 





Imagelcon icon = new Imagelcon("/home/dgilbert/temp/daylight.png"), 
Image image = icon.getImage(); 


Ad O | 


构造 方法 直到 图 片 完 全 加 载 完 成 后 才 返 回 ， 因 此 在 我 们 调用 方法 getlmage() 时 ， 下 
图 已 经 图 像 加 载 完 毕 。 
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21.1 概述 


下 面 内 容 讲 述 了 JFreeChart 类 的 参考 信息 。 


包 名 
org.jfree.chart 
org.jfree.chart.annotations 
org.jfree.chart.axis 
org.jfree.chart.editor 
org.jfree.chart.encoders 
org.jfree.chart.entity 
org.jfree.chart.event 
org.jfree.chart.imagemap 
org.jfree.chart.labels 
org.jfree.chart.needle 
org.jfree.chart.plot 


org.jfree.chart.renderer 


org.jfree.chart.renderer.category 


org.jfree.chart.renderer.xy 


org.jfree.chart.servlet 
org.jfree.chart.title 
org.jfree.chart.urls 
org.jfree.chart.util 
org.jfree.data 
org.jfree.data.category 
org.jfree.data.contour 
org.jfree.data.function 
org.jfree.data.gantt 


org.jfree.data.general 


3€ BH 
FARE 
注释 图 表 的 简单 框架 
轴 类 和 相关 接口 


为 图 表 提 供 的 属性 编辑 器 框架 (不 完善 ) 


写 图 象 文件 类 

描述 图 表 实 体 的 类 

事件 类 

HTML 图 片 映 像 工具 类 

图 表 标 签 和 信息 提示 类 

Needle classes for the compass plot 
Plot 类 和 接口 

Renderer 的 基本 类 包 


Plug-in renderers for use with the 
CategoryPlot class. 


Plug-in renderers for use with the XYPlot 


Class. 

Servlet utility classes. 

图 表 标题 类 

在 图 像 映像 区 产生 URLs 的 接口 和 类 
实用 工具 类 

Dataset 接 口 和 类 
CategoryDataset 接 口 和 相关 类 
ContourDataset 接 口 和 相关 类 
Function2D 接 口 和 相关 类 

甘 特 图 的 dataset 接 口 和 类 

38 FA dataset 3 


org.jfree.data.io 通用 的 dataset 的 Il/O 类 


org.jfree.data.jdbc JDBC 相 关 的 dataset 类 
org.jfree.data. statistics 产生 统计 的 相关 类 
org.jfree.data.time 基于 时 间 的 dataset 接 口 和 类 
org.jfree.data.time.ohlc 展示 高 低 开 发 图 表 dataset 的 类 
org.jfree.data.xml 从 xml 文 件 读 取 dataset 的 类 
org.jfree.data.xy XYDataset 接 口 和 相关 类 


更 多 的 信息 可 以 查看 javadoc 产 生 的 HTML 文 档 。 


